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文 


BDS C は，8080マイクロプロセッサ用のコンパクトで高性能なコンパ 
イラであり， CP / M システムの下で動作する.また， Z -80 や8085など 
の CPU 上でも動作する . BDS C の製作者である Leor Zolman 氏は， 
8080の限られた命令と， 64 K バイトという今では少なくなってしまった 
メモリ •ェリアに， コンパイラを移植してしまった/ しかもたった2 
つのコンパイラ.モジュールで，8080のコードを生成してしまうのであ 
る.それだけではない.このコンパイラは，コード•ジェネレーション 
のオプティマイザやその他の多くの機能を有しており，コンパイル速度 
も申し分ないものである.しかし，彼は現在に至るまでかなり苦労した 
ようで，数十回のコンパイラのバージョン • アップがそれを物語ってい 
る.いずれにしても，8080系の C コンパイラで，これだけのパフォーマ 
ンスを持つものは他に類を見ないであろう. 

コンパイラのパフォーマンスもさることながら，低価格ということも 
魅力の 一つで あり，かなりの数の人が，彼のコンパイラのユーザーであ 
る.そして彼らは，ユーザーズ•グループを結成し活発な動きを見せて 
おり，多くのアプリケーション.プログラムやユーティリティを発刊し 
ている.その数は，フロッピーディスケット数十枚に及ぶものである. 

本書は， バージ ョ ン 1.50と 1.50 a の追加イ ンフォメー ションを含めた， 
最終版のマニュアルの和訳である.原版の第1章で述べられている価格 
や新しい機能，そして古いコンパイラとの差異の節は省略し，実際の操 
作や関数の使用方法に重点を置いた.始めてコンパイラを使うときは， 
まず第4章に目を通して いただきたい. この章は， カーニハン &リッチ 
一の本の付録 A との差異について述べてあるので ， BDS C の能力の概 
要を知ることができる. 
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また ， BDS C の能力増強を計るためのアセンブリ言語とのリンク，倍 
精度整数，浮動小数点 パッケージ，そしてユーティリティとして通信プ 
ログラム，シンボリック • デバッガが付録に収録されている • 

BDS C の世界を楽しんで下さい/ 

昭和59年6月 


着 者 



Ill 


目 次 

第 1 章 序章 

1.1 はじめに . 1 

1.2 目的と制限 . 2 

1.3 システムの構成 . 3 

1.4 コンパイラの使用法 . 4 

1.4.1 コマンドとデー タフ ァイル . 4 

1.4.2 コンフイ グレー ション . 5 

1.4.2.1 CC と CLINK のコンフイグレーション . 5 

1.4.2. 2 ランタイムパッケージのオプション . 8 

1.4.2.3 BDSCIO.H と HARDWARE.H の 

コンフイ グレー ション . 8 

1.4.3 典型的なコンパイル作業 . 9 

1.4.4 CC バーサ . 1〇 

1.4.5 CC 2 コードジヱネレータ . 15 

1.4.6 CLINK !；ンカー . 16 

1.4.7 CUB C ライブラリ管理プログラム . 24 

1.5 CP/M の” Submit ”ファイル . 30 

1.6 新しい事項 . 30 

1.7 まとめ . 31 

第 2 章 CRL 閱数フォーマットと低レベル問数 

2.1 はじめに . 34 

2.2 CRL フォーマット . 34 

2.2.1 CRL のデイレクトリ . 35 

2.2.2 外部データ領域の基点と大きさ . 36 
























2.2.3 関数モジュール . 37 

2.2.3. 1必要関数のリスト . 37 

2.2.3. 2 ボディーの長さ . 38 

2.2.3.3 ボディー . 38 

2.2.3. 4再 SIK パラメタ . 38 

2.3 BDS C レジスタ割り当てと，関数コールの規則 . 39 

2.3.1 スタック . 39 

2.3.1.1 スタック • ポインタ . 39 

2.3.1.2 スタックはどれくらいのスペースを取るか？ . 40 

2.3.2 外部データ . 40 

2. 3.3 関数へのエントリとリターン . 40 

2.4 ランタイム C.CCC 内のサブルーチン ( CCC . ASM ) …43 

2.4.1 局所または外部データの取り出しルーチン . 43 

2.4.2 パラメタの取り出し . 44 

2.4.3 演算 サブルーチン . 45 

2. 4. 4 ソース • ファイル . 45 

2.5 任意ロケーションまたは， ROM で実行するコードの生成 . 45 

第 3 章 CP / M における BDS C 標準ライブラリ関数 

3.1 汎用関数 . 49 

3.2 文字の入出力 . 60 

3.2.1 コンソール I/O を直接行う CIO 関数パッケージ . 60 

3.3 文字列と文字の処理 . 65 

3.4 フアイル I/O . 71 

3.4.1 BDS C のファイル入出力の関数について . 71 

3.4.2 フアイ ルネー ム . 71 

3.4.2. 1ドライブ名 . 71 

3.4.2. 2 ューザー領域 . 72 

3.4.3 エラーの処理 . 72 





























J_ ^ V 

3.4.3.1 Ermo/Errmsg 関数 . 72 

3.4.3.2 ランダム•レコードのオーバーフロー . 73 

3.4.4 原始ファイル I/O 関数 . 73 

3.4.5 バッファ付きファイル I/O 関数 . 78 

3.5 DMA ビデオ • ボードのための作図関数 . 84 


第 4 章 1 he C programing Language の 

付録 A に関する註釈 


4.1. 86 

4.2 付録 A に対する註釈 . 87 

付 録 

付録 A 多方面にわたる注意書 . 109 

付録 B エラー メ ッセージの 説明 . 115 

B.lCC エラーメッセージ . 115 

B.2 CC2 エラーメッセージ . 125 

B. 3 CLINK エラーメッセージ . 130 

付録に初心者の C プログラマーが起こしやすいまちがい …133 

C. 1 ”= ，，と ， .==” . 133 

C.2 配列の添え寄き . 134 

C.3 いかにしてポインタを使用せずにおくか . 135 

C.4 関数はポインタをその自勒データに戻すべきでな c. 136 

C.5 フォーマル • パラメタのきまり . 136 

C.6 関数コールは （ > を持つ . 138 

付録 D C プログラムにおけるダイナミックオーバーレイ …139 
付録 E CASM- アセンブリ言語- CRL ファイル 

変換プリプロセッサ . 147 

E.1 CASM.COM の生成 . 147 

E.2 コマンド* ライン*オプション . 148 
























vi H _ 生 

付録 F BDS C ファイル I / O の手引き . 153 

F . l はじめに . 153 

F .2 原始ファイル I/O の関数 . 154 

F . 3 バッファ付きファイル I/O の関数 . 160 

付録 G BDS C コンソール I/O のひっかかりやすい点 

の解説，実例 . 169 

G . 1 はじめに . 169 

G .2 基本コンソールインターフェイス . 170 

G .3 BDOS とその複雑さ . 171 

G . 4 CIO 関数ライブラリ . 177 

付録 H 浮動小数点.関数パッケージ . 178 

H . 1 はじめに . 178 

H .2 詳しい関数要約 . 179 

H . 3 —般的な注总 . 181 

付録 I BDS C のための倍数精度整数パッケージ . 184 

I. 1 はじめに . 184 

12 内部動作 . 188 

付録 J TELEDIT 遠隔通信プログラムおよび 

ミニスクリーンエディタ VI . 1 . 189 

付録 K CDB . BDSC デバッガ . 195 

K .1 はじめに . 195 

K .2 デバッガの作成 . 197 

K .3 デバッガの起動方法 . 202 

K .4 デバッキング•コマンド：デバッガの使いかた . 205 

K .5 デバッガのコマンドのリスト . 212 

BD ソフトウェア C コンパイラ V 1.50 a のための 

追加イ ンフ オメー ション . 216 


索引 


225 






























序章 


Leor Zolman 
BD Software 
P .0 Box 9 

Brighton Massachusettes 02135 
(617)782-0836 


1.1 はじめに 


本書は，ミニコンピュータ用 高水準 言語である C を，プログラマーが 個人的 
に利用するためのものであり， CP / M.OS を使用しているマイクロコンピュー 
夕のために特別に適合させてある. BDS C の当初の設計目榡は C のプログラ 
マーが，構造的プログラムの開発を安定かつ能率的なペースで行なえるように 
することであった.最終的には，プログラマーがじっとがまんしなくても，コ 
ンパイラとリンカーは十分な速度で繰り返し，プログラムをコンパイルし，リ 
ンクし，実行するようになった. 

作業を進めて行く上で，全プロセスを繰り返さなければならないようなつま 
らないエラーが，何分も後にあげられるといったようなことは全くない. 

BDS C を用いると，こういったエラーはたいていコンパイルを始めて数秒の 
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問に税われるし，プログラマーは，スローなコンピュータに向かってブツブツ 
文句を言うかわりに， プログラミング して時をすごすことができる. 

1.2 目的と制限 

BDS C のコンパイラは， UNIX ” の 0 S と関連してベル•ラボラトリーで独削 
的に開発された C プログラミング言語 2 > のサブ•セットの実現である.コンパイ 
ラそのものは CP / M 3 4 ) の 0 S が走る8080 /Z 80のマイクロコンピュータ•シ 
ステムで実行され， CP/M 上でか， ROM か RAM の任意のロケーションで実 
行可能なコードを生成する.（ターゲットマシーンのどこかに，ランタイムで必 
要な RAM がなければならないが.〉 

この企_の主な目的は，ミニコンピュータからマイクロコンピュータ環境に 
までわたって基づいている UNIX OS のパワフルな構造的プログラミング原 
理を少し翻訳することであった. BDS C は，コンハ。イラと最終応用との両方の 
利用のために，エレガントで能率的なヒューマン•インタフヱイスに重点をお 
いて， CP / M ューティリティやアプリケーションを開発する親しみやすい環境 
を供給する. 

残念ながら， C 言語の構造は， PDP -11" のハードウェアの特質に適応するよ 
うになっており，8080のハードウェアの特質に対して適応しない . PDP -11 にと 
って自然な操作（自動記憶割付けを処理するとき，大変重要なインデックス付 
きや，非間接的アドレス指定のような）は，8080においてはむしろ非能率的な 
命令 コードへ と嫉開されることになる.このため BDS C は，8080システムプロ 
グラミング言語として PDP -11 の UNIX C のように急速に一般化することは 


1) UNIX はべル研究所の®«商標である. • 

2) 完全に言語を知るために Brian W. Kerninghan と Dennis M. Ritchie (Prentice Hall.1978) 
による C ブロダラミング 3 語を参照すること.本齐は BDS C の檐能についての说明并であり， 
C J •沾の解説, 1 f ではない.（注：この本の和訳版は，共立出版株式会社から"プログラミング 
3 雄 C-UNIX 流プログラム法と作法"という独名で発刊されている.） 

3) CP/M はデジタル • リサーチ社の分 i* 商標である. 

4) PDP はデジタル • イクイッブメント社の登録商標である. 
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ないだろうと思われるが，有能なマイクロプロセッサが，現存する8ビットマ 
シンと置き換わり，アプリケーション志向のアセンブリー言語プログラミング 
やヒストリ.ブックを放棄するに値する有能な C コンパイラが出現することは 
確実である.本書は，そのときのためのウォーミングアップと考えてもらいた 

い. 

かいつまんで言えば，アセンブリー言語のプログラミンダと比較したときに 
BDS C の大きな矛盾は，開発環境の機構と理解を重视したため，空間的かつ時 
間的な実行時のオブジェクトコードの能率の低下を招いてしまったことであ 
る.しかし，ほとんどすべての教育上の，また，ほとんどのシステムのプログ 
ラミング • アプリケーションにとって，犠牲は益よりも少ないと思う • 


1.3 システムの構成 


BDS C の必要とする実践的最小ハードウエア構成は， 40 K CP / M 2 .X のシス 
テムである. ハ。ッ ケージに含まれるほとんどのサンプルプログラムは，（分割し 
ないで）コン ハ。 イルし， 48 K システムで実行できる • 

BDS C は，ソーステキストを少しずつ読み込んでコンパイルするのではな 
く， 全ソース•グループを 一度にメモリーへ 口 ー ドし，メモリ内でコンパイル 
を行なう.これによって，前者のアルゴリズムに比べて極めて迅速にコンパイ 
ルができるのである.適当な大きさのソーステキストをコンパイルする上で， 
一番障害となるものは，現在のところソース•テキストの読み取りと， CRL フ 
アイルを書き出す時に含まれるディスク I / O であるが，これらの操作は，標準 
CP / M システムが操作できるのと同じ位の速さで行なわれる.この企画での制 
限は，ソースフアイルはコンパイルのためにメモリーへ入りきる大きさでなけ 
ればならないということである.これは最初，あなたに悪い印象を与えるかも 
しれないが，実際には， C の プログラム はトップレベルの一つの main 関数から 
生じている小さめの関数が多く集まったものである.それぞれの閲数は，別々 
にコンハ。イルされ，別のコンパイルされた関数とともに，1つの完全なプログ 
ラムを形成する. 
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このように 単一のプログラムは，多くの ソースファイルに 分ける こ とができ， 
それぞれいく つかの 関数を含んでいる.プログラムをいく つかのファイルへ区 
分化する ことによって， 個々 のソース.ファイルが 有効なメモリ ーを オーバ、 一 
フローす る こ とを防ぐだけでなく，小さな変化にともな う 再 コンパイルの 時間 
を最小限にとどめる. 

1.4 コンパイラの使用法 
1.4.1 コマン ドと データ • ファイル 

主な BDS C パッケージは次の 4 つの実行可能な コマンドで成り立っている. 

CC . COM C コンパイラ第 1 パス 
CC 2. COM C コンパイラ第 2 パス 
CLINK . COM C リンカー 
CLIB.COM C ライブラリ管理プログラム 


それから，リンカーが通常必要とする 3 つのデータ.ファイル 

C . CCC ランタイム初期化ルーチンとサブルーチン • モジュール 
DEFF . CRL 標準（”デフオルト’’）関数•ライブラリ 
DEFF 2 .CRL もう 1 つのライブラリ関数 


CC.COM と CC 2 .COM は，いっしよになって実際のコンパイラを形づくる. 
CC はディスタから与えられたソースファイルを読み取り，その上をかみ砕い 
て進み，メモリーの中に中間ファイルを残し，コンパイルを終えた後，自動的 
に CC 2 をロードし，出力 5 )として CRL ファイルをつくる • CRL(C Relocatable 


5> 必要な場合， CC がつ くり出した， 中問 ファイルは，ディスクへ 方き込まれ， CC2 によって 別々 に 
処理される.その 場合，中問 ファイルの 拡張 ファイル名として ， CCI が 用いられる . 
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の意味）ファイルは，特別な再配置可能フォーマットで 8080 マシーン•コード 
を生成する. 

リンカ ー， CLINK は，” main” 関数を含んだ CRL ファイルと付随して必要 
となる関数を指定された全ての CRL ファイルから検索する（このとき， DEFF. 
CRL, DEFF2.CRL と DEFF3.CRL は自動的に検索される）.全ての関数がリ 
ンクされると， COM ファイルを生成する. 

CLIB プログラムは， CRL ファイルの内容の処理を行なうものである. 

1.4.2 コンフイ グレー シヨン 

BDS C のコマンドは，特別な設定の手順なしで， CP/M システムのもとで実行 
できるが，パッケージの融通性を増すためにユーザーが任意に設定できるよう 
なコンパイラとリンカーのオプシヨンがいくつかある.このサブセクシヨンは， 
これらのオプシヨンの各々とそれらの選び方を説明する. 

1 .4.2.1CC と CLINK のコンフィグレーシヨン 

これらの修正を試みる前に，マスターディスクを安全に保管してあることを 
確認すること！（バックァップコピーを作成しておく） 

CC. COM と CLINK. COM の各コマンド•ファイルの最初の部分に位骰する 
特別なメモリ ーエ リアによってコント ロールされ るいくつかの機能を ユーザー 
設定できる.これらの設定を変えるためには， DDT か SID を使用し，メモリー 
の中へ CC.COM か CLINK. COM を読み込み， S コマンドを使って，その変更 
を行ない，コント ロール C を入力し，修正されたコマンドを CP/M の SAVE コ 
マンドを使用して再びディスタへ書き込む. 

修正された バージ ヨンをデイスタに セーブす るために， DDT か SID によっ 
てプリントされた 16 進の” NEXT” アドレスを 10 進にして， SAVE コマンドへ 
与えなければならない. 10 進の数字へ変換するために，次のアルゴリズムを使 
用する.まず一番左の 2 つの 16 進数字を取って，等価の 10 進数を計算する（た 
とえば， 3C80 は 3C をもたらし，これは 10 進数で 60 である）.それから，一番右 
の 2 つの数字が 00 である場合のみ， 1 を引くと（たとえば，上の 60 は 60 のまま 
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である.というのは， 3C80 の一番右の 2 つの数字は 80 であって 00 ではない）•最 
後に得た値は SAVE に与えるための数字である. 

CC.COM と CLINK. COM は，同じ構造の 5 バィトの設定ブロックを含んで 
いる. CC.COM のブロックの基本アドレスは 0155h で， CLINK のブロックの 
基本アドレスは 0103 h である.ブロックの構造は次のようになる. 

アドレス 機 能 デフオルトの値 

base + 〇 デフォルトのライブラリ•ディスク FF (現在値） 

base + 1 デフォルトのライブラリ • ユーザー領域 FF (現在値） 

base + 2 SUBMIT ファイルが処理されるディスク 00( ディスク A) 

base + 3 割り込み （ 0 か 1 ) のためのポール • コンソール 01( 可能） 
base + 4 処理終了後，ワームブートを行う 00( 行なわれない） 

ブロックの中の各項 H は，1バイトの長さである. 

敁初の2バイトの設定値は，デフォルト•ディスクとユーザー領域を指定す 
るもので， CC と CLINK ではそれぞれ，"ライブラリ•ディスク”，"デフォ 
ルト領域”として扱われる. CC では，ライブラリ•ディレクトリは# include デ 
ィレクティブ内の各角弧く〉で网まれているファイルをみつける場所を補足 
し 6 )， CC2.COM をみつける場所も指定する. CLINK では， DEFF. CRL. 
DEFF2. CRL. DEFF3. CRL (もしあれば）と C. CCC を格納している場所を指 
定し， CLINK コマンド行に指定された "main，，CRL ファイルからディレクト 
リ内にない全ての CRL ファイルの格納場所も指定する. 

デフォルトのライブラリ•ディスクの値は，0がドライブ A を指定し，1は 
ドライブ B を指定し ， FFh (10 進数で 255) の値は， 現在ログされた ディスクカす 
デフォルトのライブラリ • ディスタとして使用される.デフォルトのライブラ 
リ •ユーザー 領域のために，〇—31の値は符号する ユーザー 領域を表わし ， FFh 

6)# include 文で衍定される二取引用符で W まれたファイルネームは，設定とは無関係に指定さ 
れたファイルを求めて，视在のディレクトリを検索する. 



1.4 コンパイラの使用法 


7 


(10 進数で 255) の値は現在のユーザー領域はデフォルトのューザー領域になる 
ことを指定する.ライブラリ•ディスクとユーザー領域は FFh へ設定されてい 
るので，現在ログされたドライブとユーザー領域には常にライブラリのファイ 
ルを含んでいると仮定される. 

3つめの設定値は，” Submit file ” の処理中に存在する $$$. SUB ファイル 
がどのドライブにあるかを指定する.可能な値は，前記のようにデフォルトの 
ライブラリ•ディスクのためのものと同じである. 

CLINK は，エラーが起こったときは，いつも保留中のサブミット•ファイル 
を消そうとする.一方， CC は， 一 x オプションが与えられたときにそうしよう 
とするだけである.というのは，ほとんどのシステムは常にドライブ A 上に $$$• 
SUB ファイルを誇くからであり，これは CC と CLINK がデフォルト値によっ 
て設定されるようになる方法である.しかし，ユーザーが $$$• SUB ファイルを 
いつものドライブ A のかわりに，いわゆる税在のドライブ上に入れるためにシ 
ステムをカスタマイズするなら，そのときはこのパ、イトを， Olh から FFh へ fi 多 
正すればよい. 

4つめの設定値は，コマンドの実行中に，システムのコンソールを割込みコ 
ー ド（コントロール ー C ) のためにポールするべきか，否かを CC あるいは， 
CLINK に告げるフラグである•もし可能になったら（ゼロ以外のもの）コマン 
ドの実行中，コントロール ー C がタイプされなければユーザーによってコンソ 
ー ル上にタイプされた入力は無視される.コントロールー C がタイプされた場 
合，処理はすぐに打ち切られ，コントロールはコマンド•レベルにもどる.も 
し，無効になつたら（ゼロ）コンソールはポールされない.コンソールをポー 
ルするために，非常駐のコマンドを必要とすることもなく，割り込みを有する 
システムではタイプアへッドを利用することができる. 

5つめの（そして最後の）バイトは， CC と CLINK が，それぞれの処理を終 
えた後，直接 CCP に戻るか，あるいはワーム•ブートを行うかの指定を行うも 
のである.デフォルトでは， CCP へ直接戻るように設定されているが， CP/M 
ライクな システム （ CROMIX 上の CP / M シミュレーターは1つの例であると 
聞いたことがある〉上で， CCP へ直接的にもどるのは，正しく作動しない•こ 
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れはたぶん， 0 S が有効スタック•ポインタを非常駐コマンドへパスしないから 
であり， CC や CLINK が戻ろうとしたとき，システムをクラッシュしてしま 
う.もし，ユーザーがコンパイラを用い正しい出カファイルを書き込んだ後に 
爆走する場合，ワーム•ブート.バイトをゼロ以外の値にセットする必要があ 
る • 

かいつまんでいえば，この設定案によって，大きな容 tt のディスクを持つユ 
ー ザーが すべての標準 ヘッダーと， ライブラリ•ファイルを キープす る特殊な 
ドライブと ユーザー 領域を指定することを可能にする.ライブラリ•ディスク 
と ユーザー 領域のバイトは， 一つの 単位として共に考えられるべきである.も 
し ユーザーが一つの 修正を行えば，たぶん他のものも変えたくなるだろう. 

CC 2. COM は，設定する必要はない • CC . COM は，適切な情報のすべてを含 
めて CC 2 •に処理を渡す. 

1.4.2. 2ランタイムパッケージのオプション 

CCC . ASM は， ユーザーの カスタマイズできるいく つかの EQU シンボルを含 
んでいる.ランタイムのパッケージを再びアセンブルしたり，ライブラリを適 
切に修正する方法についての詳しいことは第2章を参照のこと • 

初心者のユーザーにとって，ランタイムパッケージの再設定のプロセスは多 
少やっかいなので，注意すること. 

CCC . ASM の中の NFCBS シンボルは， 間かれるファイルの最大数を規制す 
る.これは供給されるバージョンでは8にセットされている • 一度に開かれる 
ファイルがもっと必要なら，単にこれを，必要な値（各々のファイル追加はラ 
ンタイムパッケージが38バイトほど大きくなる）に変更すればよい. 

1.4.2. 3 BDSCI 0. H と HARDWARE . H のコンフィ グレー ション 

標準 I / O ヘッダーファイル BDSCIO . H は， NSECTS という定義された値 

をもっている • これはバッファ付き I / O ライブラリが， コントロールす るバッ 
ファの大きさを定義するものである . N SECTS は8に設定されているから，デ 
イスクへのアクセスが おこる前に パ、ッ フア付き I/O オペレーションが， 1024バ 
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イトのデータをバッファする.もし，ューザーが CP/M の BIOS (基本•入力 
/出カシステム）の中で，ブロッキング/デブロッキング化する1 K のセクタ 
を持つシステムを実行中なら，そのときは冗長バッファリングを削除したり， 
オープン•ファイルごとに 7/8 K バイトのフリ ーメモリーを得るために，ユーザ 
一は NSECTS を8から1へ修正したくなるかもしれない. 

I/O ポート • ナンバーやマスクなどのシステム従属ハードウェアの特徴は， 
HARDWARE . H というヘッダーファイルの中で定義される.これを含むプロ 
グラムがコンパイルされる前に， HARDWARE . II は，ターゲットコンピュー 
夕 • システムのハードウェアの特性を基にして修正されるべきである. 

1.4.3 典型的なコンパイル作業 

例として，ここに FOO . C と呼ばれる単一のソース•ファイルをコンパイルし 
たり，リンクしたりする順序をあげる. 

コンパイラは，次のコマンドで呼び出される 


A > cc foo . c く Cr > 

サイン•オン•メッセージをプリントした後， CC はディスクから，ファイル 
FOO.C を読み取り，そして，中間コードを作成し始める. CC の処理が終了し 
たら，メモリーの使用状態を表示し， CC 2 .COM をロードする. CC 2 では， CRL 
ファイルを作成するために中間コードを解析し，エラーが起こらなければファ 
イル F 00. CRL をディスタへ書き込む. 

次のステップでリンカーが起動する. 

A > clink foo [他のファイルや必要なオプション]く cr > 


未決定の関数参照がなければ，ファイル F 00. C 0 M がっくられ 


A > foo [引数]く cr > 


によって実行される. 
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重要事項： パッケージの中のすべての COM ファイルのコマンド行は 
先行 ブランク なしで CP / M へ，タイプ•インされなければな 
らない.これはコマンド行での先行ブランクがコンパイラに 
よって，生成された COM ファイル内の argc と argv の値の 
計算ミスを引き起こすからである. 

つづいて，コマンドの 文法の詳細である. 

1.4.4 CC バーサ 

コマンド•フオーマツト： CC name , ext [オプション]く cr > 

C プログラムの標準の拡張ファイルネームは， ' C ” であるが，どんなネーム 
も拡張ファイルネームも指定することが可能である. CC はまず指定されたフ 
ァイルをオープンしようとする•拡張ファイルネームが指定されていなければ, 
また指定したファイルが，見つからなければ， CC はそのファイルネームに 
"C ”という拡張ファイルネームを付加し，新しく設定されたネームでそれを 
もう一度オープンする.もし，ファイルネームがデイスタ名を含んでいるなら 
ば（例えば” b : foo . c ”） ソースファイルは,そのドライブ上に存在すると仮定さ 
れる•そして， コン ハ。イラの出力もそのデイスタに対して行なわれる •# include 
デイレタテイブに対して，二重引用符の中で与えられたユーザー領域/ドライ 
ブの指定なしのファイルネームは コマン ド行上に与えられた マスタ • ファイル 
ネームと同じデイスタから得られる. 

CC がコンフイグレーションセクションで示されたような”コンソール入力 
のキャンセル ”指定がされて いない ときは， コントロール ー C をタイプすると， 
コン パイ ル 処理は 中断され， オペ レーテイングシステムに戻る. 

ソースファイル名の指定の後に，コンパイル作業のオプションを指定するこ 
とができる.オプションはマイナス記号で先行する.現在サポートされている 
オプションは，下記のとおりである. 


一口は，すべての# define と# include デイレクテイブの展開が終了した後 
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に，行番号を付けて，ソース•テキストをユーザーのコンソール上に表示する. 
このオプションは，不一致のコメント•デリミタを探知するのに便利である. 
- P を指定すると，閉じられていないコメントは引き続くテキストすべてを消 
してしまう.また，最後の目に見えるテキストはまちがって区切られたコメン 
卜が始まっている場所をユーザーに教える.この出力は， CC を呼びだす前に， 
コントロール P をタイプすることによって， CP / M の” LIST ”装置へ出力さ 
れる. 


一 a d [ n ] は CC の処理が正常に終了した後，ディスク立のユーザー領域 
J 1 から CC 2. COM を自動ロードする.デフオルトでは， CC 2 は現在ログ•イン 
されているディスクか，設定手順で定義されたデフオルトのドライブ/ユーザ 
一 領域のところかのいずれかからロードするとみなされる.文字” Z ”がドラ 
イブ名として与えられる場合，中間ファイル ". CCI ” を後の CC 2 の呼び出しの 
ために，ディスクへ書き込む.そして CC 2 の自動ロードは行なわれない. 

-d 五は， CC か CC 2 の処理中にコンパイルエラーが起きなければ，コン 
パイラの CRL 出力がディスタ土へ害き込まれるようにする .一 a z オプシ 
ョンが指定されている場合，一 d は， . CCI ファイルを書くディスタ名を指定す 
る.デフオルトのデイスタはソース • ファイルが含まれているデイスタと同じ 
ものである. 

-m xxxx は， CP / M 以外の環境でコードを生成するためのコンパイルの 
ために，ランタイムパッケージ （ C . CCC ) のスタートする位置を16進で指定す 
る .ランタイム ハ。 ッケージは，デフオルトでは CP / M の TPA のスタートから 
常駐する.もし，代替アドレスがこのオプションの使用によって与えられるな 
ら，リンクする前にランタイムパッケージを与えられたロケーション用のマシ 
ーンコードとして，必らず再ァセンブルすること • また， CLINK を使用すると 
き，適切なァドレス値を一 I 一 e — t を用いて，与えることも忘れないよ 
うに ， BDS C のオブジェクトを CP / M 以外の環境にカスタマイズすることに 
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関する詳しいことは，第2章をみよ.生成された COM ファイルの先頭に位置す 
る C . CCC は， main と，他のルート•セグメント関数（もしあれば）を，分離 
することができない. 一 m を指定した場合は， CC によって CC 2 が自動的に口 
ードされなければならない. 

一 e xxxx は， ランタイムの外部データ領域のスタート•アドレス （16 進） 
の指定を行う.普通，外部データ領域は，プログラム•コードの最後のバイト 
のすぐ後に続けて始まる.そして，ランタイムハ。ッケージの，すべての外部デ 
ータは CLINK によって設定される間接的手段によるポインタによって，アク 
セスされる. 一 e が使用されるとき，外部データ •ボイ ンタを使用するかわりに， 
コンパイラは外部データを直接的にアクセスするための （ Ihld と shld 命令を使 
用して）コードを生成することができる.これは多くの外部データをもったブ 
ログラムのパフオーマンスを高めることになる.ただし デバ、 ック中のプログラ 
ムは，このオプションを使用しないこと•プログラムがうまく動作したなら 一 e 
と前述したような外部データ領域の値を指定して再びコンパイルする.（前回よ 
りも，オブジヱタトコードは，短かくなる.）コードサイズがどれだけ縮められ 
たかを見つけ出すために， CLINK は"最後のコード•アドレス”の値を表示す 
る.それから， 一 e オプションで適切な低い方のアドレスを指定して，再びそれ 
を全部コンパイルする.しかし，あまり近づけすぎない方が良い.というのは， 
ユーザーはプログラムの変更を行なえばそれに対してサイズは変動するように 
なるので，おそらく，指定された外部データ領域はオーバーラップ ( CLINK が 
検出し，レポートする）することになる .一 e を指定した場合は， CC によって 
CC 2 が自動的にロードされなければならない. CLINK オプション ー e にも，関 
連する事項があるので参考にすること.もし，このオプションを指定した場合, 
外部データアドレスが最後のコマンド • ファイルの中のプログラムや OS のあ 
る部分とオーバーラップするなら， CLINK は脊告メッセージをプリントする. 

一 〇を指定すると，実行速度に対して最適化されるようなコードを生成する. 
普通，ランタイム•ハ。ッケージ内の単調なコードシーケンスを，共通のサブル 
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ー チンと 置換する.これは コードの長さを小さく するが， サブルーチンへのリ 
ンクの オーバーへッ ドの ために，実行速度がスローダウンする結果になる •一 〇 
が使用される場合，それらの サブルーチン•コードの 多くは， イン•ラインコ 
ードに展開されるので，より速い（しかしより長い） オブジェクト • プログラ 
ムが生成される.最も高速な コードを 生成するには，一 e オプションと 一〇 と 
を， 同時に指定する.できるだけ短い コードの ためには，一 e だけ を 使用し，一〇 
を 使用してはいけない. 一 〇 を 指定した場合は， CC によって CC 2 が自動的に 
ロードされなければならない. 

-x を指定すると， コンパイル 作業中に エラーが 発生したら， CP/M " SUB ¬ 
MIT " ファイルを 削除する. CC が SUBMIT ファイルから 使用されるときは， 
コマンド 行に 一 x スイッチを 指定すべきであり，そうすると， コンパイルエラ 
一の発生にともなって， コマンド•レベルに 戻るまえに， ” $$$• SUB ，， の一時 
的 ファイルを 削除する . CC が 単独で使用されるとき， 一 x は必要のない ディス 
ク勋作を引き起こすので，使用するべきでない. 

一 r 上は，上 K バイトをシンボル•テーブルのために，用意することを意味 

する. ” Out of Symbol space ”のエラーが起こったなら，このオプションは， 
シンボル • テーブルのために割り当てられるメモリー空間の斌を増やすために 
使⑴される.もし，ユーザーが” Out of Memory ”エラーを引き起こしたな 
ら ，一 「は，シンボル•テーブル•サイズを滅じるために使用され， ソース •テ 
キストのためにもっと多くのメモリー空間を与える.けれど， " OutofMem - 
ory ” が発生した場合のより良い解決手段は，ソースファイルをより小さなモ 
ジュールに分割することである.デフオルトのシンボル • テーブル•サイズは， 
10 K である. 

一 c は， "コメントの 入れ子”機能を無効にし， コメントが UNIX C による 
のと同じ方法で処理されるようにする•たとえば， 一 c が与えられたとき， 
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/ * print f (” hello ” )； / * this prints hello * / 

のようなラインは，全てコメントとみなされる •一 c が使用されない場合，コン 
パイラは，こういったコメントが終結したとみなさずに，次の*/が現われるま 
でコメントとする. 

ひとつのソースファイルは，63以上の関数定義を持つことができない•とは 
いうものの， C プログラムはいくつものソースファイルからつくりあげられる 
し，その各々は，63までの関数を持つことができるのである • 

CC によってエラーが検出されたなら，コン ハ。 イル作業は中断され，二番目の 
コンパイル作業のフェーズ （ CC 2) へと進んだり ， CCI ファイルをディスタへ書 
き込む（どのオプションが与えられたかによって）ことはない. 

実行スピード： 約 20 行/秒、. ソースファイルがメモリーへロードされた 

後には，ディスク•アクセスは，コンパイル処理が終わる 
まで，発生しない.最後のディスク動作が起こってから， 
少なくとも （ n /20) 秒が経過するまでクラッシュが起こ 
ったと想定しないこと（それ以後は想定した方が良い〉•こ 
こで， n というのはソース•ファイルの行数である. 

例： 


A > cc foobar.c - rl 2 -ab く cr > 

CC を呼び出し，ファイル foobar.c をコンパイルする • シンボル•テーブル， 
サイズは， 12 K バイトにセットされ， CC 2 .COM はディスク B から自動ロード 
される： 


A > cc cibelle.c -p -o く cr > 

CC を呼び出し，デイスタ C からファイル belle . C をロードしコンパイルする • 
テキストは，# define や# Include の処理の後，コンソール上に（行番号を付け 
て）出力される. CC がエラーをみつけなければ， CC 2 .COM は現在ログされた 
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デイスタかデフオルトのドライブ/ユーザー領域（セクション 1.9.2 で設定され 
ている〉のいずれかから，自動ロードされる.そして，オブジェクト•コード 
はスピードアップのために最適化される. 

1.4.5 CC 2 コードジ I ネレータ 

コマンドフオーマット： CC 2 name < cr > 

普通， CC 2. COM は， CC によって自動的にロードされるので，このコマンド 
は使用される必要はない.コマンドが与えられた場合，フアイル name.CCI 
メモリーへ^ロードされ， 処理される. 

エラーがなければ， name . CRL と呼ばれる出カファイルが生成され, name . 
CCI (もしあれば）は削除される. 

CC 2 にはオプションはない. 

CC では，ファイルネーム内にデイスタ名を指定すると，そのデイスタが入力 
と出力のために使用されるようになる. 

CC が CC 2 を自動ロードするとき， CC 2 内のいくつかのバイトは， CC のコマ 
ンド行に与えられたオプションに従って，セットされる. CC 2 が単独で呼び出 
される場合 （ CC によって自動ロードされないとき） CC 2 が実行を始める前に， 
ユーザーは これらの値が指定された値にセットされていることに気をつけなけ 
ればならない.これは必要なことではないが，もし， ユーザーが 容 a の小さな 
デイスク装置から CC 2 を別に呼び出す必要があるなら，セットされる必要のあ 
るデータ値は次のようなものである： 
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アドレス 

デフオルト 

オプション 

機 能 

0103 

00 

一 a 

CC 2 が自動ロードされたなら，典，他はゼロ 

0104 

01 

-0 

一〇が与えられたなら（実行速度の最適化）ゼロ， 

他は1 

0105 -6 

010 Oh 

—m 

ランタイム • オブジェクトの C . CCC の開始アド 

レス 

外部データ領域の開始アドレス （ CC に - e が与え 

られたなら）. 

0107 -8 

none 

—e 

0109 

00 

—e 

外部データ領域の間始アドレスが与えてくれる 

場合典，他は0 


16ビットの値は，上下バイトを逆にすること.（最初は，低い方のバイト，次 
は高い方） 

CC 2 の実行スピード：約70行/秒（元のソース•テキストに基づく） 
実行中に，コントロールー C が入力されたら，コンパイル作業は打ち切られ 

コントロールはコマンド • レベルに戻る • 

例： 

A > CC 2 foobar く cr > 

1.4.6 CLINK リンカー 

コマンドフオーマット： CLINK name [他のフアイ ルネー ムまたは 

オプション]く cr > 

フアイル name . CRL は, main 関数をもっていなければならない. name. 
CR し と,指定された他のすべての CRL (— f ) オプションが出てくるまで）フ 
ァイル内の関数はすべてメモリーにロードされ，リンクされる. 一 f オプション 
がコマンド行に現われたなら，それに続いて指定されたすベての CRL ファイ 
ルは，必要な関数を走査するためのものである.それは，（前の CRL ファイル 
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か，現在走査されているファイルのいずれかから）前もってロードされた関数 
によって必要になるとわかっているもののみをロードし，リンクする.指定さ 
れた CRL ファイルすべてが，検索された後，標準ライブラリ•ファイル DEFF 
*. CRL を必要とされるライブラリ関数のために自動的に走査する.ライブラ 
リ•ファイルが検索される順序は，いつも同じである.最初は， DEFF . CRL ， 
次に DEFF 2. CRL . そして最後に， ユーザーが 供給するなら， DEFF 3. CRL •も 
し， ユーザーが これらの自動検索されるライブラリ.ファイルの中の関数と同 
じ名前を持つ関数を書いたなら，こういった関数は常に，コマンド行に指定さ 
れた CRL ファイルの1つの中におかれるべきである • DEFF 3. CRL の中にお 
かれる場合， DEFF . CRL と DEFF 2. CRL の中で同様に指定された関数が，削 
除されない限り，読み込まれることはない. 

CLINK はデフォルトで，すべての指定された CRL ファイルがデイスク上に 
あると仮定し，すべてのライブラリ•ファイル （ C . CCC と DEFF * . CRL ) は 
コンフィグレーションのセクション（セクション 1.4.2 をみよ.）の中で定義さ 
れたようなデフォルトのドライブと ユーザー 領域からそれぞれロードされる • 
ドライブ名をコマンド行の main 関数を含んだファイルのファイルネームの前 
に罱くなら，与えられたドライブは，コマンド行で指定される CRL ファイルす 
ベてのためのデフォルト値になる.各々の追加 CRL ファイルは” d : ”とい 
うフォームのディスタ指示子と，” nn /” というフォームの ユーザー 領域の指 
示子もしくは，その一方をファイルをさがす明白な場所を指定するために含ん 
でもよい.両方の指示子が使用される場合， ユーザー 領域の指示子をはじめに 
衍定しなければならない. 

指定された CRL ファイルが上記の検索ルールに従ってみつけられない場 
合，デフォルトのドライブとユーザー領域（セクション 1.4.2 をみよ）によって， 
指定されたディレクトリも検索される.これは，ユーザーが1つのデフォルト 
のドライブ/ユーザー領域の中に，共通に使用されるライブラリ • ファイルを 
おくことを可能にし，リンク作業に異なったドライブとユーザー領域をァクセ 
スできるようにする. 

与えられたすべての CRL ファイルが検索された後，未定義の参照が残って 
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いると， CLINK は"会話型モード”に入る.ここで CLINK は未定義の関数名 
を表示し，他の CRL ファイルを検索することを可能にする. 

実行中にコントロール ー C がタイプされると，リンク処理は中断され，コマ 
ンド • レベルへ 戻る. 

リンク作業のオプションは，ファイル名との混合をさけるためにオプション 
の前にマイナス記号を付ける • 1つのマイナス記号の後に，いくつかのオプシ 
ョンを，一度に指定してもよい.現在使用できるオプションは，下記のとおり 
である. 

一 s コンソール上にロード•マップとモジュールのサマリを出力する • 

一 f (ファイルネーム…）は，続けて指定された CRL ファイルのすべてを 口 
ードするかわりに，走査されるようにす る. CLINK はこのオプションに出会う 
まで，コマンド•ライン上で指定された各々の CRL ファイルの中のすべての関 
数をロードする •一 f オプション以後に続く CRL ファイルはロー ドされずに 
走査される.これが意味しているのは，はじめのころの（いくつかのファイル 
や％在のファイルの中で他の関数によって，前もって参照された関数だけが， 
プログラムにリンクされるということである • 

注意： この新しい 一 f オプションは， BDS C の1.50バージョン以前 
の一 f とはちがった動作をする. 一 f は L 2リンカーの"一 L ” 
オプションと同様に動作する • 

一 e xxxx は，外部データ領域の開始ァドレスを xxxx (16 進）で指定す 
る.普通，外部エリァは生成されたコードのすぐ後から開始されるが，一 e オプ 
ションを指定すれば，この機能は無効になる.このオプションは，コマンドを 
チェインする場合，新しいコマンドの外部データ領域の開始アドレスを，前に 
実行したコマンドと同じアドレスにしたい時には必要である.この値を見出す 
ためにはまず，最初に全ての CRL ファイルと 一 s オプションを用いて， 
CLINK を実行する •一 s オプションなしでは， CLINK は，それぞれのファイル 
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の” External Start At :” の表示をしない • それから前述の 一 s オプションで 
得られた 一番の大きな” External Start at ” アドレスを， 一 e オプションの才 
ペランドとして与え再度リンクする. ROM のためにコードを生成するときは， 
このオプションは， RAM の適切な位置に外部デ ー タ領域を置くために使用さ 
れるべきである. main 関数を含んだ CRL ファイル ( name . CRL ) が， CC の 
一 e オプションを用いて，コンパイルされたなら， CLINK は CC コマンド行で 
指定されたアドレスを自勋的に検知する.しかし，もしリンク作業で指定され 
た他の CRL ファイルのどれかが，一 e オプションを使用しなかったり， main 
関数とは異なる一 e の値を使用して，関数をコンパイルした場合には，出てく 
る COM ファイルは正しく作動しない. CC の一 e オプションの使用なしでコ 
ンパイルされた CRL ファイルは， main 関数を一 e を使用してコンパイルした 
ときのアドレスと全く等しい値を CLINK の一 e オプションで指定した場合に 
限って，正しくリンクされる • 

一 z は，ランタイムの初期化のとき，外部データ領域をゼロにクリアするの 
を抑止する. 一 z が使用される場合，すべての外部のものはランダムな値にな 
る.さもなければ，外部のものは全てゼロにクリアされる. 

一 t xxxx は,予約されたメモリーのスタートを xxxx (16 進で与えられ 
る）にセットする.命令 Ixi sp . xxxx が生成された COM ファイル 7》 の最初に; S 
かれる. CP/M ではランタイム内の全てのプログラムコードと内部/外部デー 
タエリアの大きさが，指定された値に入りきるような十分な大きさでなければ 
ならない•もし， ROM ベースで走らせるプログラムを作成するなら，この値は， 
RAM の最終アドレス+1に設定しなければならない. 


7) 件通一 t が使用されないとき，生成された COM ファイルは次の*で始まる. 
lhld bose +6 :ベースページから BDOS ポインタを得る. 

sphl : BDOS のベースへスタック•ポインタを役定する. 
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一〇 newname は， COM ファイルの出力が， newname . COM と名付けられ 
るようにする.ディスク名がその名前に先立つなら，その出力は指定されたデ 
ィスクへ書き込まれる.デフォルトの出力は現在ログされたディスタである • 
コロンと，その前に置かれたディスク名を，ファイルネームなしで与えるなら， 
COM ファイルは，ファイルの名前を変更することなく，指定されたディスタへ 
害き込む. 

一 n は，ランタイム•スタックが CP/M の CCP (コマンド•プロセッサ）と 
オーバーレイするかわりに， cep を保存させるような値に設定し COM ファイ 
ルを出力する.これはランタイムのメモリーを 2 K バイトほど減じるが，実行 
終了後， ディスクからワーム•ブートする必要なしに コマンド.レベルへ戻る 
ことができる.したがって， 一 n は頻繁に使用されるプログラム や メモリーを 
ちょっとしか必要としないプログラムにとって便利である.このオプシヨンは， 
NOBOOT コマンドを実行するのと ㈤ じような影背をもっている. NOBOOT 
は， L 2 のような他のリンカーとリンクされたプログラムが，ワーム•ブートを 
行なわずに CCP へ戻るようにするために，与えられている •一 n は， 一 t オプ 
シヨンが同時に指定されているときは無視される.なぜなら，そのメカニズム 
は相入れないもので，一 t が俊先権を与えられているからである. 

一 w は name . SYM という シンボル • テーブル.フ アイ ルを デイスクへ 書き 
込む.ここで name は生成された COM ファイ ルのものと同じである.この シン 
ボルファイ ルは， シンボル 名と リンクに 含まれたすべての関数の絶対ア ドレス 
の値をもっている • これは， デバ、ッグす る目的のため， SID を用いて使用され， 
あるいは オーバーレイ•セグメントをつく る時，一 y オプシヨンに よって使用さ 
れる（下記をみよ） 


一 y sname は，デイスクか ら指定された シンボル.ファイル sname . SYM 
を 読み取る.そして，現在の リンクの ためそこで定義された関数の名前す ベて 
のアドレスを 使用する•一 w と 一 y オプションは， オーバ、ー レイをつ く るた めに 
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一緒に 作動す るように，次のように設計されている：，ルート，セグメント 
( TPA からロードされ，最初にコントロールを受けるランタイム•ユーティリ 
ティ•ハ。ッケージを含んでいるプログラムの部分）をリンクするとき， 一 w オプ 
ションは，ルートの中で現われるすべての関数のアドレスを含んでいるシンポ 
ル • テーブル • ファイルを書き出すために与えられるべきである.それから， 

才 ー バーレイ•セグメントをリンクするとき， 一 y オプションは"親”ルート. 
セグメントのシンボル•テーブルの内容を読むために，使用されるべきである. 
そして，それによって，一般的なライブラリ関数の多重コピーが，ランタイム 
にあらわれるのを防ぐ.この手順は，もう1つ下のレベルにも用いることがで 
きる：オーバーレイ•セグメントをリンクするとき， 一 w オプションは， 一 y 才 
プションと共に与えることが可能であり，それを行うと，新しく定義される局 
所関数と，読み込んだシンボルの定義を含んだシンボルファイルが生成され， 
この操作は，必要なだけレベルを下げることができる. CLINK コマンド行の 
一 y オプションの位置は，重要である•つまり，一 y オプションで指定されたシ 
ンボル•ファイルは， 一 y オプションの左に指定された CRL ファイルの検索が 
終った後にだけ，検索される.このように最長の結果は main CRL ファイルネ 
ームのすぐ後に， 一 y オプションを指定することである•もし SYM ファイル内 
のシンボルがすでに定義されたシンボルと同じ名前であるなら，その影響に対 
するメ ッ セージがコンソールに出力され，そのシンボルの古い値が保持される. 
オーバ-レイ•セグメントを生成するための 一 y の使用に関しては，"付録 D ’， 
をみよ. 

一 I xxxx 生成されたコードのロード•アドレスが ， xxxx (16 進）になるよ 
うにする • このオプションは，オーバーレイ•セグメント（一 v と関連して） 

を生成するとき，あるいは，標準外の環境で実行するコードをつくるときに， 
必要なだけである.後者の場合， CCC . ASM は適切なアドレスのために再設定 
されてなければならないし， xxxx を用いている C . CCC の新しいバージョン 
をつくるために，再びアセンブルしなければならない.この場合，一 e と一 t 才 
プションもまた，適切な RAM 領域を指定するため，使用されるべきである. 
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一 ▽は， オーバーレイ •セグメントを作成することを指定する.作成された 
コードの 中には，ランタイム •ハ。ッケージが 含まれない.というのは，ランタ 
イムのパッケージのコピーがデフオル トによる TPA のベース， あるいは CC 
の 一 m オ プショ ンの中で指定されたア ドレスの いずれかで，すでに常駐してい 
ると想定されるからである. 

一 c d [ n ] は，ライブラリ•ファイル （ DEFF . CRL . DEFF 2. CRL . C . CCC 
と，もしあれば DEFF 3. CRL ) と，コマンド行で指定されてはいるが，現在の 
ドライブ/ユーザー領域でみつからない CRL ファイルを，ディスク立とユー 
ザー領域 n から，取り込むように CLINK に命令する.このオプションは， 
CLINK コンフィグレーション • セクションで設定されたデフオルトのドライ 
ブ/ ユーザー 領域の仕様を無効にするために使用される（セクション 1.9.2 をみ 
ょ） 

一 d [" args ”] 一 d は，すばやくテストするために， COM ファイルとして 
ディスタへ# き込むかわりに，リ ンク 作業によ ってつ くられた COM ファイル 
がすぐに実行されるようにする.引数のリストが二重引用符で囲まれて指定さ 
れているならそれは， CCP からのパラメータと同じものになる. 

- d は， TPA のベースのところとはちがうロード•ア ドレスを 持つセグメン 
卜のために使用することはできない（つまり，一 d は，ルート•セグメントのた 
めに使用される）.内部の矛盾のために，一 n が与えられている場合は，一 d は無 
祝される. 

-r xxxx は前方参照のテーブルのために xxxx (16 進）バイトを予約する. 

(デフォルト値は約 600 h ) ” Ref table overflow ”のエラーが起こったときは， 
このオプションはもっと多くのテーブル.スペースを割り当てるために使用さ 
れる. 
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A > clink ted 一 s —t 6000 - o joyce く cr > 

ここで， CLINK はファイル TED . CRL が main 関数を含んでいると仮定す 
る. TED . CRL のすベての関数と， DEFF . CRL . DEFF 2. CRL そして存在する 
なら DEFF 3. CRL 8> から必要な関数とがリ ンク される. リンク 終了後モジュー 
ルの サマリが コンソールに 出力される.実行時のスタックは600 Oh からスター 
卜し，下位アドレスに向って増えていく （6000 h 以後のメモリーは COM ファイ 
ルに よって手をつけられない），また COM ファイル自身は JOYCE . COM とい 
う名前になる. 

A > clink b:lois 6/ c:vicky -t janet — s く cr > 

この例で， CLINK は（ドライブ B :の） LOIS . CRL と（ドライブ C :のユ 
-ザー領域6の） VICKY . CRL からすべての関数をロードし， JANET . CRL 
(デイスタ B から，というのは LOIS . CRL が入っているデイスタがこのリンク 
作業でデフオルトになる）と DEFF . CRL : それからたぶん DEFF 3. CRL (セク 
ション 1.9.2 によって設定されたデフオルトのデイスタ/ユーザー領域から）か 
ら必要な関数をリンクする.そして，リンク終了後，コンソールにモジュール 
のサマリを出力する •一 t オプションは与えられないので， CLINK はすべての 
TPA (非常駐プログラム領域）が，コードとデータにとって有効であると想定 
している.生成された COM ファイルはデフオルトによって LOIS . COM と指 
定される（一〇オプションは与えられてなかったから）.そして，ファイルは現 
在ログ•インされたデイスタに書き込まれる. 

注意：外部の変数を共用するいくつかのファイルが，共にリンクされ 
るとき main 関数を含んでいるファイルは，他の全部のファイル 


8 > DEFF 3. CRL がユーザーの供給したライブラリ•ファイルとしてもし存在するならば， DEFF . 
CRL と DEFF 2. CRL が走 A されてしまつた後にまだ未定義のシンボルがあると，力的に走 
食される. DEFF 3. CRL が存在しない場合，リンカーは何もしない • 
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の中で使用される外部変数のすべての宣言を含んでいなければな 
らない.これは，リンカーが main の含まれているファイルから得 
た外部領域のサイズを用いるからであり，この値はライブラリ関 
数の endext () が正しい値を戻せるように，また出てきた COM 
ファイルの中に適切なパラメタをセットするために，使用される 
のである.また， BDS C の外部変数は， UNIX C の外部変数のも 
のよりもっと FORTRAN の COMMON 文に近いので，外部宣言 
の配列は，プログラムの個々のソース•ファイルの範囲内では等し 
くあるべきである.このように，プログラムの各ファイルに含まれ 
ているヘッダーファイルには，互換性を確実にするためにすベて 
の外部宣言を含める. 


1.4.7 CLIB - C ライブラリ管理プログラム 


コマンドフォーマット ： CLIB < cr > 

CLIB プログラムは，ユーザーに次のような目的で供給される. 

a ) CRL ファイル間で関数を転送させる 

b ) 個々の関数を改名し，削除し，検査させる 

c ) 新しい CRL ファイルをつくらせる 

d ) CRL ファイルの内容を検査させる 

CLIB 操作を始める前に， CRL(C 再配置可能ファイル）ファイルの構造を理 
解しておくと役に立つ： 

CRL ファイルは，独立してコンパイルされた C 関数の集まりで， 0000 の基点 
をもつ 2 進の 8080 マシーン • コードのイメージである.各関数と共に記憶され 
るものは CLINK による使用のために再配置可能なァドレスを解くための"再 
配置パラメータ”のリストと，与えられた関数によってコールされた付随関数 
の名前である.コード，再配置リスト，必要関数リストの集合は1つの 関数モ 
ジユール と呼ばれる. 

CRL ファイルの最初の 4 つのセクタは，そのファイルのためのデイレクトリ 
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であり，ファイルに含まれる関数モジュールやそれらの位置情報を含んでいる 
CRL ファイルのトータル•サイズは 64 K バイトを超えることはできない（関数 
モジュールは2バイトのアドレスによって配置されるからである）.しかし，最 
も効率的なのは CRL ファイルのサイズを CP / M •ファイルエクステント （16 K 
バイト）の大きさに，制限することである. 

CRL ファイルについての詳しいことは，第3章をみよ. 

CLIB が起動されると，タイトルメ ッ セージと"関数 バッファ •サイズ”を表 
示する. パ、ッ ファ •サイズは，転送処理の間にどれくらいのメモ 1 ノーが関数の 
中間記惊に用いられるかを示す.大きな関数を fe 送したり ， 引き出したり する 
と，動作しないことがある. 

初期化に続いて， CLIB は，アスタリスク （*> をブロントし，コマンドを待 

つ. 

CRL ファイルを処理するには，まず， CRL ファイルを次のようにオープンす 
る. 


* open file # [ d :] filename く cr > 

ここで， file # は，そのファイルがオープンされたままでいる限り，そのファ 
イルの filename と関連されるための”ファイル ナンパ、一” を指定する一桁の 
数の識別子 （0 — 9) である.ゆえに，10までのファイルを同時に オーブンす 
る ことができる. 

ディスク名は， CLIB がどんな物理ディスク上からでも， CRL ファイルを操 
作できるようにすることを可能にする. 

フアイルをクローズするためには（フアイルに対してなされた変更を永続的 
にして）， 


个 close nle # く crv 

与えられた ファイル •ナンバーは，後の open 処理によって，新しい ファイル 
へ 割り当てられるようにするため，空になる.変更された ファイルのパ、 ックァ 
ップファイルは， 名前， name . BRL を用いて作られる. close 操作は，いく 分 
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時間をとり，大きなファイルが呼ばれるときには，ユーザーのディスク•ドラ 
イブのわずらわしい騒音をひきおこすであろう. 

ファイル に対して変更が行われない限り，あるいは ユーザーが 余分な フアイ 
ル•ナンバーを 必要としない限り， ファイルをクローズ する必要はない.例え 
ばコピーされるためだけに オープン された ファイルはクローズ する必要はな 

い. 

CRL ファイルがオープンされると，ファイルの デイレクトリ (最初の4セク 
夕）のコピーがメモリーへロードされる.ファイルに対して変更が行われると 
( append ， transfer , rename ， delete の コマンドに よって）メモリーの中に 
あるディレクトリもそれに順じて変更される.しかし，更新されたディレクト 
リをディスクへ書き戻すには，ファイルをクローズしなければならない.この 
ように，もしユーザーが，今まで行なったことを，すべて取り消したい場合は, 
単に，そのファイルをクローズしなければよい. 

append , transfer の処理を取り消したい場合は，少し余分な作業を必要とす 
る.これは後で説明する. 

すべてのオープンファイルの関連統計のリストを見るには 

* files < cr > 

とする. 

具体的な CRL ファイルの内容をリストし，その中の各関数の長さを知るた 
めには，次のコマンドを用いる. 

* list file # く cr > 

CRL フアイル間で関数をあちこち動かすにはいくつかの方法がある.関連フ 
アイルすべてが オープン されたとき，関数を コピーす るのに一番の近道は， 

个 transfer source-file # destination-file # function-name く cr > 

これは，指定された関数をソース•ファイル source - file # から，目的フアイ 
ル destination-file #にコピーし，ソース•フアイルのオリジナルは，削除しな 
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い. function-name に曖昧な指定をするには， * と？の文字を使用する•この 
ときは，曖昧な名前と一致するすべての関数が転送される • 

ファイルをあちこち動かすための他の方法は， " extract - append ” の方法を 
使用することである. 

extract コマンドは次のフオームをしている • 


氺 extract file # function-name く cr > 


これは，与えられたファイルから申•一の関数を引き出すために，また，関数 
バッファ（メモリー）の中にそれをストアするのに使用される.その関数をフ 
ァイルに書き出すためには， 

* append file # [ name ] < cr > 

とする.ここで， name はオプションであり,関数を書き出すときに，関数の名 
前を指定する. 

* append file # < cr > 

は，関数の名前を変更せずに，その関数をファイルへ害き出すために用いられ 
る. append は，1度に1つしか file # を指定できないので，関数を,いくつかの 
CRL ファイルに書き出すには，書き出すファイルごとに append を使用しなけ 
ればならない. 

CRL ファイル内の関数の名前を改名（リネーム）するためには， 

平 rename nle jf old-name new-name く cr > 

これは，そのファイルに対して変吏されるので， close はその変更を永続的に 
するために行なわなければならない. 

新しい（空の） CRL ファイルをつくるには， 


* make filename く cr > 

とする.これは filename . crl と呼ばれるディスク•ファイルをつくり，そのデ 
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ィレクトリを空に初期化する.それに対して関数を書き込むためには，最初に 
open を使用し，それから transfer か extract / append といった方法を使用す 
る. CLIB は，同じディレクトリの中に存在する CRL ファイルと同じ名前を持 
つ新しい CRL ファイルを作ることを認めない. 

ファイルから，1つの関数を（あるいは，関数の集合を）削除するためには， 

ゃ delete file # tunction-name < cr > 

を使用する. 

関数の名前は， * と？といった文字を使用して，曖昧な指定をすることもで 
きる.ファイルに対する関数の削除を終結するためには，続いてクローズする 
必要がある.関数を削除しても，そのファイルが実際にクローズされるまでは， 
関連する CRL ファイルの中のどんなディレクトリスペースをも解放しない. 
このように， CRL ファイル•ディレクトリが一杯になっていて，その関数のい 
くつかを置き換えたい場合，まずはじめに，不必要な関数を削除し，それから， 
新しい_数をファイルの中に転送するために，いったんクローズし再びオープ 
ンしなければならない. 

コマンド構文要約は，次のコマンドをタイプすることによって，参照できる. 

* help く cr > 

CLIB を 終了して， コマンド •レベルへ戻る ために， 次の コマンド 

* quit く cr > 

を与えて， CLIB が表示する確認メッセージに，必ず答える. 

すべての CLIB コマンドは， 最初の一文字だけで指定することができる. 
万一， ファイル に対する変更を，本当はしたくなかった の だと決めたなら， 
そして，それがすでにすんだことであったなら ， quit コマンドはファイルの 編 
集を終了するために，また，行われた変更をすべて中止するために使用される. 
ユーザーがファイルに 付加したり，転送したりしない限り， 
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* quit file # く cr > 

とタイプすれば，そのファイル上の操作全部を打ち切って， close がなされたか 
のようにその file # を解放する. 

もし，ファイルへのアペンドや転送が なされて しまってから，打ち切りたい 
場合も quit コマンドが使用される.しかし加えて， quit した後そのファイルを， 
再オープンし，それからすぐにファイルをクローズしなければならない.この 
手順の原理は次のようになっている：ユーザーがァペンドや転送を行うと 
き，アペンドされている関数は CRL ファイルの最後のところから書き込まれ 
る.また，ユーザーがそのエディトを打ち切るとき，古いディレクトリはもと 
のままにされる.しかし，アペンドされた関数はそのディレクトリの中に現わ 
れなくても，データ領域の中に依然として存在している.ファイルをオープン 
し，すぐにクローズすることによって，ディレクトリの中に現われる関数だけ 
が，そのファイルと共に残り，結果的に他の”架空’’の関数を取り除く. 

次のサンプル•セッションは， DEFF.CRL ファイル内の頭文字が” P ”で始 
まる関数すべてを，ドライブ B に新しく作成する CRL ファイル NEW.CRL に 
転送するものである. 

A > clib 

BD Software C Librarian VI .50 

Function buffer SIZE = xxxxx bytes 

* open 0 deff 

* make b:new 

* open 1 b:new 

* transfer 0 1 p * 

* close 1 

* quit 

( Quit ) Are you sure ? y 

A > 
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1.5 CP / MO " Submit "ファイル 

CP/M " Submit ” ファイルは， C プログラムをコンパイルしたり，リンクし 
たりするプロセスを簡単にするために作成されうる.初期のバグが除去されて 
いて，かつ， ソース •ファイルの中にどんな エラー も存在しないと信用してか 
ら，自分でもっている C ソース プログラムを単にコンパイルしたり，リンクし 
たり，実行したりするために，サブミット•ファイルの最も簡単なフォーム（関 
数をリンクするために他の特別な CRL ファイルを必要としない）は，次のよう 
に現われる. 

CC $1 .C 
clink $1 — S 
$1 

# 

ここで， LIFE . C と呼ばれるソース•ファイルをコンパイルしたい場合，ユー 
ザーは， 


A > Submit c life < cr > 


とタイプすればよい（サブミツト•ファイルは， C . SUB と命名されていると仮 
定する）. 


1.6 新しい事項 


1 .BDS C パッケージの中の COM ファイルや，コンパイラによって生成 
された COM ファイルを呼び出すとき，ユーザーのコマンド行 （ CP / M へ 
タイプされるように）は，先行ブランクやタブを含んでいてはいけない. 
もし，先行するホワイト.スペースがある場合 ， CCP (コンソールコマン 
ド•プロセッサー）は，正しい方法でコマンド行を展開しないようである. 
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2. MP/M II で実行する場合，ランタイムパッケージ （ CCC.ASM — C . 
CCC ) の" MPM 2 ”の定義を1にして再アセンブルしなければならない. 
これは， C プログラムが実行している間，ランタイムパッケージが実際に 
オープンされたすべてのファイルを クローズす るのを確実に行うためで， 
そのシステムはファイル•スロットを使い果たさない.普通， MPM 2 シス 
テム以外のもとでは ， BDS C ランタイムハ 。ッ ケージは，読み取りのためだ 
けにオープンされたファイルをわざわざ クローズ しない. 


1.7 まとめ 


バグなどが兌つかった場合は，次の所までお知らせ下さい. 


Leor Zolman 
BD Software 
P .0. Box 9 

Brighton , Massachusetts , 02135 

(617) 782-0836 (夜の方が結構，東部標準時 ( EST ) 1 :00 AM (日本 
時間で2 : 00 PM ) まで） 

技術的なバグのレポートで，業者の方と言い争うようなことはなさらないで 
ドさい•バグレポートを直接 BD ソフトウェアに教えていただくことによって， 
かつて間かれたことのある問題を知ることもできるし，ほんの少しの時間で， 
その欠点を補うことができるからです. 

この コンパイ ラの開発のデバッギングの段階で，非常に貴重な フィー ドバッ 
クと御支援をいただいた次の方々に心より感謝申し上げます • 

Lauren Weinstein Sid Maxwell 

Leo Kenen Bob Mathias 

Rick Clemenzi Bob Radcliffe 
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Tom Bell 

The Real Cat 

Jon bieber 

A 1 Mok 

Scott Layson 

Phillip Apley 

Tony Gold 

Charles F . Douds 

Ed Ziemba 

Robert Ward 

Scott Guthery 

Les Hancock 

Earl T . Cohen 

Ted Nelson 

Sam Lipson 

Ward Christensen 

Dan MacLean 

Jerry Pournelle 

Mike Bentley 

Will Colley 

Carlos Christensen 

Richard Greenlaw 

Perry Hutchinson 

Tim Pugh 

Paul Gans 

Steve Ward 

John Nall 

Tom Gibson 

Mark Miller 

Roger Gregory 

Jason Linhart 

Don Lucas 

Calvin Teague 

Rev . Stephen L . de Plater 

Bob Shapiro 

Nigel Harrison 

Cal Thixton 

Jeff Prothero 

Gary Kildall 


特に ， Dennis M . Ritchie 氏 ， Ken Thompson 氏，それから ， UNIX やオリ 
ジナルの C の開発にあたったベル研究所のコンピューテイング•サイエンス • 
リサーチセンターのスタッフの皆様方に心より感謝申し上げます. 

BDS C のユーザーズグループは，しだいに組織化されてきました.このグル 
ープからの援助，ニュースレターやアップデートされたコンパイラの安価な入 
手方法についての連絡先は， 
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BDS C User’s Group 
P . O . Box 287 

Yates Center , Kansas 66783 
(316)625-3554 

なお，税在のところ ， BDS C パッケージははじめての方でもユーザーグルー 
プから購入できます. 
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CRL 閲数フォーマットと低レベル閲数 


2.1 はじめに 


本章は，コンパイルされた C の関数と，マシーン•コードのサブルーチンを 
リンクする必要のあるアセンブリ/マシン言語のプログラマーに対して向けら 
れているものである.また， CRL フォーマットを詳しく説明しており，アセン 
ブリ言語から CRL ファイルを作成し， C リンカーによって他の関数のように 
取り扱われるようにするため，それらの関数をどうやって生成するかについて 
も詳しく説明している. C 関数のために使用されるパラメタを受け渡したり， 
コールしたりする規制も，ランタイムパッケージの中に存在する有用なサブル 
ー チンと共に説明されている. 

2.2 CRL フォーマット 

BDS C のデイスタに含まれている CASM . C は， CP / M の ASM アセンブラ 
と共に使用されるためのものである.このプログラムによって，アセンブリ言 
語の関数を特別な” CSM ”フォーマットで（1.46以前のリリースの” CMAC . 
LIB ” マクロ •パッケージよりも， 標準ァセンブリ言語に近い.）記述すること 
ができる.それから， ASM . COM アセンブラのために， CSM ソース•ファイ 
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ルを ASM ソース • ファイル へと 自動的に 変換する. CASM . SUB と呼ばれる 
CP / M の " Submit ，，ファイルは，この 手順のほとんどを自 動的 にするために与 
えられる. 

CRL ファイルを生成する CASM と ASM を効果的に使用するために ， CRL 
ファイルがどのようにして編成されるのかを知ることは，絶対必要という訳で 
はない 力す， CRL フォーマットの詳しい説明は，完全を求めてのことである • 

2.2.1 CRL のディレクトリ 

CRL ファイルの最初の4つのセクタ ー 9 > は， CRL ディレクトリ と呼ばれる • 
そのファイルの中の各関数のモジュールは，ディレクトリの中に符号するエン 
トリをもっており，モジュールの名前 （8 文字までで，最後の文字は高位ビッ 
卜が1になっている）と，そのファイル内 10》 のモジュールのバイト•アドレスを 
示す2バイトの値から成る. 

絞いて，最後のエントリは，空白バイト (0 x 80) とそれに続く1ワード （2 
バイト）のファイルの中の，次の有効アドレスを示すアドレスが続けられる. 
実際の間数モジュールの最後に，次のモジュールを偶数 （16 バイト）のアドレ 
スから開始させるために， ハ。ッ ドが入れられることがある.ディレクトリの中 
には，どんなパッドも存在しない. 

例： CRL ファイルが次のモジュールを含んでいる場合， 


名前 

長さ 

foo 

0 x 137 

yipe 

Ox 2 c 5 

blod 

Ox 94 A 


9> ファイルを凋べるために， DDT や SID を使用している場合，これらのセクターはメモリー • 
ロケーション 0100 h -02 FFh にロードされる. 

10) CRL ファイルのすべての閲数モジュールの開始アドレスは， 0 x 0000 から OxOlFF までに常駐 
しているディレクトリと共に 0 x 0000 を起点とする.ロケーション 0 x 200-0 x 204 は，リザーブ 
されているので，一番低い閱数モジュールの開始アドレスは 0 x 205 である. 
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そのファイルのためのデイレクトリは，次のよう 11 > に現われる- 


46 4 F CF 05 02 59 49 50 45 C 5 50 03 
F 0 0 r nn nn Y I P E E ' nn nn 


42 4 C 4 F C 4 20 06 80 70 OF 
B L 0 EX nn nn null-entry 

2.2.2 外部データ領域の基点と大きさ 


CRL ファイルの5番目のセクタの最初の5バイト（そのファイルの基点から 
数えて， 0 x 200 〜 0 x 204) は， CLINK が使用するランタイムの外部データ領域の 
基点（一 e オプションによって CC へ明示して指定される場合）と，大きさの情 
報を含んでいる • この悄報は ， "main " CRL ファイルとして CLINK コマンド 
行に指定されたもののみ有効であり，それ以外のものでは使用されない. 


コンパイル作業で外部データ領域を設定するために， 一 e オプションを指定 
するならば，5番目のセクタの第1バイトは 0 X BD という値を持つ.それ以外 
は，その値はゼロでなければならない.第2，第3のバイトは 一 e オプション 
のオペランドとして与えられたアドレスを含んでいる. 

5番目のセクタの第4，第5のバイトは，そのファイルの範囲内で宣言され 
た外部データ領域の大きさを含んでいる（最初に，低位バイト，二番目は高位 
バイト） CLINK は，” main ” CRL ファイルの範囲内（” main ，，関数を含んで 
いる CRL ファイ ノレ） で，これらの特別な ロケーションからいつも 外部データ領 
域のサイズを得る.” main ”関数を含んで いない CRL ファイルの中で，これら 
のバイトは使用され ない. 


id 関数名の敁後の文字の7ビット n は常に1である. 
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2.2.3 閣数モジュール 

CRL ファイル内の各 関数モジュール は,独立構成要素であり，関数のための 
再配置パラメタとコールする他の関数の名前のリストに，関数自身の2進のマ 
シーン.コードのイメー ジを加えたものを含んでいる. 

関数モジュールは， アドレスとは無関係 で, CRL ファイルの範關内のロケー 
シヨンに対して，物理的に動き回れることを意味している（しばしばこれは， 
CLIB がモジュールを引きずり冋すときに，使用される.関数モジュールのフォ 
ー マットは，次のようになっている. 

必要関数のリスト 
ボディーの長さ 
ボディー 
再配置パラメタ 

2.2.3.1 必要閩数のリスト 

ューザーが 作って いる 関数が，他の CRL 関数を コールする 場合，それらの関 
数リストはその モジュールの 中の最初の項目でなければならない.その フォー 
マットは名前の最後の文字の7ビット目が1になって いる 大文字だけからなる 
名前の一連のリストである. ゼロ バイトはそのリストを終結させる.空リスト 
(関数が他の関数を コール しないときのように） は， 単一の ゼロ バイトだけで 
ある. 

たとえば，関数 foobar が, Putchar , getchar , setmem と呼ばれる関数をコ 
ー ルすると仮定すると， Foobar の必要とする関数のリストは，次のように現わ 
れる： 


47 45 54 43 48 41 D 2 50 55 54 43 48 41 D 2 
get char"put char 7 
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53 45 54 4D 45 CD 00 
s e t m e m (終結) 


2.2.3.2 ボディーの： R さ 

次にくるバイトは， ボディー の長さ(バイト）である.長さを表わすワード 
は，低位バィト，高位バイトの順である. 

2.2.3. 3 ボディー 

関数モジュールの ボディー の部分は, 0000を基点にした，関数の8080コード 
が含まれる. 

必要関数のリストがない場合，そのコードはボディーの敁初のバイトから始 
まる.必要とされる関数のリストが，！個ある場合，疑似ジャンプ•べクトル • 
テーブル （！ 個の jmp 命令で成り立っている）と，それを飛び超すためのジャ 
ンプ命令を， ボディー の先頭に贤かなければならない. 

たとえば，上記の foobar 関数のボディーの始まりは，次のようになっている. 


jmp 000 Ch 
jmp 0000 
jmp 0000 

jmp 0000 く関数のコード〉 


C3 OC 00 C3 00 00 C3 00 00 C3 00 00 く関数のコード〉 


2.2.3.4 再配置バラメタ 

ボディーに続いて，ボディーの範囲内の局所アドレスを参照する命令のオペ 
ランド.フィールドに対するアドレスの補正値（ボディーの開始アドレスに準 
ずる）である再配置パラメタが含まれる. CLINK は，このリストの中のエント 



2.3 BDS C レジスタ荆当てと，関数コールの規則 


39 


リによつてさし示めされている各ワードを取り，それに対して，関数の実行時 
ベースのアドレスを付加する. 

再配置リストの中の最初のワードは，いくつかの再配諝パラメタがそのリス 
卜の中に与えられているかというカウンタである.このようにして， n 個の再 
fiiiiS パラメタがある場合，再配置リストの長さ（長さのバイトを含む）は， 
2 n _+ 2バイトになる. 

たとえば，ロケーション0 x 22, 0 x 34, 0 x 4 f , 0 x 61 で配置されているような4 
つの局所ジャンプ命令を含む関数は，次の再配 K リストを持つ. 

04 00 23 00 35 00 50 00 62 00 12) 


2.3 BDS C レジスタ割当てと，関数コールの規則 
2.3.1 スタック 

ランタイムは，すべての局所（自勋）記惊割り当てだけでなく，関数呼び出 
しのときにパスするすべての引数も，スタック上におかれる. 

2.3.1.1 スタック•ボインタ 

スタック•ポインタは， SP レジスタの中に格納され，ランタイムで，ユーザ 
一がアクセスできる，メモリー領域のトップアドレスへ初期化される. コンパ 
イラが，有効メモリーの終りと思う正確な場所は，リンク時に与えられる オプ 
シヨン によ つて 決まる • デフオル トでは，スタック•ポインタは， CP/M BDOS 
のベースに初期化されるので， CCP の領域はスタックに遛き換わる.したがつ 
て，プログラム実行後は， CCP をメモリーに戻すため，ワーム•ブートが行な 
われる •一 t オプ シヨ ンが使用される場合，その引数がスタックの初期値とな 
り，一 n オプ シヨ ンを使用すると SP は CCP のベースに初期化されるので，デ 


12> 命令のアドレスは，冉配凋を必要としている実際のアドレスのオペランドをさし示すため, 
1つ袖やさなければならない. 
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フォルトよりも少ないスタック•スペース (2 K ) しか得られないが，実行終了 
後，ワーム•ブートを行わずに， コマンド •レベルに戻れる • 

2.3.1.2 スタックはどれくらいのスペースを取るか？ 

スタックには，すべての局所 （自動的） データ 記惊， ハ。ラ メタ， リターン. 
アドレス， それから中間式の値を持っていて，高位メモリーから始まり，下が 
ってゆく. 

スタックの大きさは，最大の関数ネスティング時の局所データ領域の大きさ 
に，中問式の結果などのことを考えて200〜300パ M 卜加えた値を必要とする • 

ワーストケース2での局所記惊の域を求める場合，ユーザーの使用できるフ 
リー•メモリ—の破は，次の公式によって求められる • 

topofmem ( ) -endext ( ) — (n + fudge ) 

ここで， fudge の値が500ぐらいだとかなり安全である. topofmem と endext 
ライブラリ関数は，実行中のプログラムの最高位のポインタ（スタックの位®) 
と外部データ領域+1の位諝のポインタを，それぞれ戻す.このように endext 
() の値は有効メモリーの第ーバイトへのポインタである • 


2.3.2 外部データ 


外部データ領域は，通常，プログラム•コードの直後から始まり，外部デ ー 
夕の終りから，スタックまでの割り当て可能領域とは，区別される. 

2.3.3 関数へのエントリとリターン 

C の関数が，コントロールを受け取るとき，それはたいてい次の仕事を与え 
られた順で行う.： BC レジスタをスタックにプッシュする.スタック上の局 
所データのためにスペースを割り当てる（必要とされる局所記憶の傲によって 
SP を滅じる）.そして， BC レジスタを一定のベース•オブ•フレームのポイン 
夕として使用するために，新しい SP 値をコピーする. SP のかわりに， BC を 
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使用する理由は， SP が，プッシュ，ポップなどで，激しく変動するので，変数 
のアドレス計算が，かなり混乱してしまうからである. 

BC の 古い 値は， いつもコールす る ルーチン のために保持されてなければな 
らない. 

コール された I 対数が，局所 スタツクのフレーム•スペースに nlocl バイ トを必 
要とするならば， BC をプッシュし， SP から nlocl を滅 じ, SP を BC へ コピー 
し，その後に，局所オフセット loffset を持つ自動変数のアドレスは,次の公式 
によって簡単に計算される. 


( BC ) + loffset 


その関数がパラメタを受け取る場合， n # 目のパラメタのアドレスは， 


( BC ) + nlocl + 2 n 


によって求められる. 

ここで1の値は，最初のパラメタに対して，1になり， 2#目のハ。ラメタに 
対しては2…というようになる.この最後の公式が意味するのは，コールする 
プログラムは，常に逆順でパラメタをスタックにプッシュするということ，引 
数は，プログラムをコールする直前に，プッシュしなければならないというこ 
とである•コールされた_数が， BC レジスタをプッシュした後には，現在の SP 
と敁初のパラメタの間に， a ) セーブ された BC のレジスタと， b ) コールす る ルー 
チンに対するリターン•アドレスという2つの16ビット値，すなわち， 4バイ 
卜のデータが含まれている.この案は，各々のパラメタが2バイトの記憶領域 
を取ることを必要としている.このように，バイト単位のパラメタ （ Char 型） 
はいつもパラメタとしてパスされる前に，16ビットの値（符号拡張でなく，高 
位バイトをゼロ化する）に変換される. 

処理を完了するとき（リターン前だが)，コールされた関数は， nlocl 分だけ 
SP を増やすことによって，局所記憶割当てを解除し，セーブされた BC をスタ 
ックからポップし， BC レジスタのペアをリストアしてから，コールされたプロ 
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グラムに戻る. 

コールしたプログラムは SP 値をパラメタがプッシュされる前の値にリスト 
アする.コールされた関数は，これを行うことはできない.というのは，コー 
ルしたプログラムがいくつのパラメタをプッシュしたかを求める方法がないか 
らである（たとえば， printf 関数は,パラメタの数が一定していない.， 

普通，コールする関数の資任というのは， 

1. 逆順で，ハ。ラメタをプッシュする. 

2. 従厲関数をコールし， HL か DE レジスタのいずれかに，重要な値をもっ 
ていないことを確認する（従滅関数は， DE を使用する事を許され， HL の 
中に値をもどす）. BC レジスタは従城関数による変更からは，"安全”で 
あると思われる.というのは，規則によって，コールされる関数は，パス 
された BC レジスタ値をいつも保存しなければならないからである. BDS 
C パッケージで与えられたコンパイラによってつくられたすベての関数も 
アセンブリ言語でコード化された関数のすべてもこれを行う必要がある. 

3. 関数から戻ったら， SP をパラメタがプッシュされる前の値に戻し， HL 
レジスタのペアを保存するように気をつける（従域関数から戻された値を 
含んでいる）.スタックボインタを記憶する一番簡単な方法は，プッシュさ 
れた引数の数だけ POP 命令を行えばよい. 

コールされた関数の必要とされる規則は， 

1. BC レジスタがコールされたプログラムにもどる前に，変更される可能 
性があれば BC レジスタをプッシュする. 

2. 局所記憶の必要があれば，必要とされる数のバイト数を， SP から滅じて 
スタック上に適切なスペースを割り当てる. 

3. 必要とあれば， BC レジスタ•ペアをベース•オブ•フレームのポインタ 
として使用するために， SP の新しい値をコピーする.もし， BC がセーブ 
されなかった場合はこれを行ってはいけない. 

4. 必要な処理をする. 

5. 処理が終わったとき，局所のフレーム•サイズを SP に加え，局所記愤割 
り当てを解除する. 
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6. スタックから BC をポップする（ステップ1でセーブされた場合のみ）. 

7. HL レジスタにリターン値を格納し，コールされたプログラムに戻る. 

2.4 ランタイム C . CCC 内のサブルーチン （ CCC . ASM ) 

アセンブリ言語による関数によって使用できるランタイムパッケージの中の 
有用なサブルーチンがいくつかある.これらのルーチンは，局所/外部データ 
のアクセス，ハ。ラメタのアクセスと，演算の3つに分かれている • 

2.4.1 局所または外部データの取り出しルーチン 

第1グループの6つのサブルーチンは， BC レジスタか，外部データ領域の先 
頭によって与えられるオフセットから，8ビットか，16ビットかのいずれかの 
オブジェクトを取り出すために使用される.ここで，オフセットは8ビットか 
16ビットの値として指定される.たとえば，外部データ領域（ロケーション 
extms に記憶されている）から eoffset バイトのオフセットの位置に記惊され 
ている外部変数の16ビット値を取り出すための直接的な手順は 


lhld 

extrns 

；get base of external area into H 

xi 

d , eoffset 

;get offset into HL 

dad 

d 

;add to base-of externals pointer 

mov 

a , m 

;perfom 4 -step 

inx 

h 

;indirection to 

mov 

h , m 

;fetch value at 

mov 

1 ,a 

;( HL ) into HL . 


外部変数を取り出すための特別なコールを用いると，次のようになる. 


call sdei 
db eoffset 


; single - byte - offset , double-byte value external 
; indirection , with eoffset 256 
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このコードの 方が，少ないメモリーで済む（正確には4バイト対11バイト）. 
eoffset の 値が255より大きい場合は， eoffset を db ではなく, dw で与え， ldei 
ルーチンを 使用する.このような，値を取り出すサブ ルーチンの 全 レパー トリ 
一に関する完全なリストや説明文に ついては， CCC . ASM を参照せよ. 

2.4.2 パラメタの取り出し 

2番目のサブルーチンのグループは，スタック上に置かれる関数の引数を， 

A レジスタと HL レジスタに取り込む（低位バイトの値は， A と L レジスタに， 
高位バイトの値は， H レジスタにそれぞれ格納される）•たとえば： ユーザーの 
アセンブリ言語による関数が呼ばれたばかりだとすると，サブルーチン 
maltoh の 呼び出しは,最初の引数を HL と A に格納する. maltoh ("Move 
Argument 1 toH ”の 意味）は， ロケー ション SP + 2( ユーザーの _数が SP をみ 
るように）の16ビットの値を取り出す. ma 2 toh (” Move Argument 2 toH ’’ ） 

ルーチンへのコールは， スタックから2番目の16ビット引数を取り出し， HL と 
A に格納する•もしスタックからパラメタを取り出す前に， BC レジスタをプッ 
シユするなら，そのスタック上のすべての項目は SP 値からもう2バイトによ 
ってオフセットされるし，最初の引数を取り出すためには， ma 2 toh を コールし 
なければならないし，2番目の引数を取り出すには， ma 3 toh を, 3番目は 
ma 4 toh •••と続く.このように，これらの サブルーチンを 使用するとき，スタッ 
クの 深さ を 考慮すること は 重要である. 

関数の引数を取り扱うためのあまり祓雑で ない 方法は，特に BC をプッシュ 
したり，スタック上で何か行なう前に，ユーザーの関数の中で，始めに ar^hak 
を コールする ことで ある. Arghak は, RAM 領域（普通， C.CCC の内で）内 
の14 バイ ト •バッファに， 最初の7つの関数の引数を コピーす る.また，閲数 
操作の継続して いる 間，単に Ihld 操作を行なうことによって，それらの値を呼 
び出し可能にする.これは， arghak を使用す る 関数が,他の arghak を使用す 
る 関数を コールしていない ことを前提とする. arghak が コール された後は, 最 
初の引数は絶対 ロケーションこ 記憶され，二番目は逆^…と続く.これら 
の シンボルは 後に説明され ている ように， BDS . LIB の中で定義され冬 
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2.4.3 演算サブルーチン 

最後のサブルーチン•グループは，演算のグループで，これらすべては HL と 
DE を引数として受け取り， HL に結果を戻す.ここではこれらの機能に関し 
て，あまり スペース をとりたくないので，有効なサブルーチンを知るためには, 
ランタイムパッケージ •ソース•ファイル ( CCC . ASM ) を調べてもらいたい • 

2.4.4 ソース•ファイル 

CCC . ASM は，ランタイムパッケージの ソースで あり，この中に前述のルー 
チンのすべてが書かれている.パッケージ内のヘッダー ファイル BDS.LIB は 
C.CCC (アセンブルされた CCC . ASM ) 内のすべてのエントリ•ポイントが定 
在されている. CSM フ オー マットの ソース•ファイルで， これらのエントリ • 
ポイントを，名前で コールで きるようにするには，次の命令， 

# include く bds . lib 〉 

を含んでいなければならない.もし， ラン タイ ムパッ ケージをカスタマイズす 
るために， CCC . ASM を修正する必要があれば， BDS . LIB 内の対応するァドレ 
スも修正しなければならない. 


2.5 任意ロケーションまたは， ROM で実行するコードの生成 

BDS C は，コンソール • コマンド.プロセ ツサ （ CCP ) から 実行される非 
常駐 コマンド •ファイル （ユーザー 領域開始 アドレス (100 h ) から 始まる） を 
生成す る. こういった普通の状態で いるとき， ランタイムパッケージ ( C . CCC ) 
とその専有領域は， コマンド •ファイルの最初の1500程のバイトを占め， コン 
パイルされた コード （" main ” 関数で始まる）がそのすぐ後に続く • 

CP / M 非常駐コマンドを生成することが目的ならば，特別な作業を必要とし 
ないが，それとは異なるロケーションで実行することのできるコード，あるい 
は ROM の中へ茜•かれるコードを生成するためには， 
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a ) ランタイムノ、。ッケージをカスタマイズすること. 

b ) 関数ライブラリのマシンコード化された部分を再アセンブルするこ 
と. 

C ) ライブラリの C コード化された部分を再コンパイルすることが必要で 
ある.そのパッケージをカスタマイズする一般的な手順は，次のように 
なっている • 

1. ランタイムパッケージ （ CCC . ASM ) を，必要な設定を行うために，変 
更して再アセンブルする. • そのターゲット•コードが CP / M のもとで操作 
されていない場合，適切な EQU をゼロへセットすることによって， CP/M 
特有のサポート • コードを除去し，ランタイムパッケージの中に含まれて 
いる RAM 領域とランタイムパッケージの両方を小さくし，ランタイムパ 
ッケージの中の CP / M 用のエントリ•ポイントを未定義のままにしてお 
く.だから，未定義の状態でそれらのエントリ•ポイントをコールするよ 
うなコードは生成されない.また，そのパッケージの専有データ領域のた 
めのコードの開始アドレスと， RAM のロケーシヨンを定義するために適 
切な EQU を必ず設定すること. 

2. CCC . ASM をアセンブルした後には，その開始アドレスが TPA のべ一 
スのところになければ，二進のイメージを生むために CCC . HEX ファイル 
を単に LOAD することはできない.もし，開始アドレスがどこかほかにあ 
るならば，メモリーへ^そのファイルを読み込むために DDT か SID を使 
用し， TPA のベースへそれを移動し， CP / M をリブートし，新しい C.CCC 
イメージを書きもどすために SAVE コマンドを使用する. CCC . ASM の 
二進のイメージがつくられた後（指名された CCC . COM かあるいはそれ 
以外)， C . CCC となるようにそれを改名する. 

3. すべてのアドレスが，新しい CCC . ASM のアセンブリコードから得ら 
れる値とマッチするようにファイル BDS . LIB を エディ ットする.この ス 
テップをチェックするのに良い方法は， BDS . LIB を BDS . ASM にリネー 
ムし，それをアセンブルし， BDS . PRN と CCC . PRN の一番左側に現れる 
値を比較することである. 


2.5 任思ロケーションまたは ROM で実行するコードの生成 
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4. CASM を使用して，マシン語ライブラリファイル （ DEFF 2 A . CSM ， 
DEFF 2 B . CSM , DEFF 2 C . CSM ) から CRL ファイルを生成する. CP/M 
以外の環境のためにパッケージを設定する場合，アセンブル作業の前にラ 
イブラリ関数からすべての CP / M に関する関数をまず除去すること•ほと 
んどのファイル I / O とシステム従厲の関数は， DEFF 2 C . CSM に含まれて 
いる. 

5. 非標準ロード•アドレスにコードをコンパイルするのに， CC . COM を使 
用するとき，新しいパ、ッケージの開始アドレス （0 x 100 と異なる場合）を 
コンパイラに知らせるために，一 m オプションを使用する•必ず 一 m を使用 
して STDLIB . C と， STDLIB 2. C を再コンパイルする.それから ， CLIB 
を用いて STDLIB 1. CRL と， STDLIB 2. CRL のすベての関数を新しい 
DEFF . CRL に転送する. 

6. ロード•アドレス， RAM の最高位アドレス，それぞれのターゲット，プ 
ログラムの外部データ領域のベースを一丨 ，一 t , 一 e のオプションでそれ 
ぞれ指定して CLINK を行なう. 

7. PROM を作成する. 
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CP/M における BDS C 標準ライブラリ関数 


BDS C パッケージの 中の， ファイル DEFF . CRL と DEFF 2. CRL は，標準 
ライブラリ⑶のオブジェク ト •コードを 含んでいる. これらの CRL フォーマッ 
卜のファイル 内には， C プログラムで利用できる有用な C の 関数が含まれて い 
る. CLINK は コマンド 行で明白に指名されている CRL ファイル 全部が検索さ 
れた 後に， 自動的に ライブラリ•ファイル ⑷を検索する. このように， CLINK 
がライブラリの 走査を行なう前に読み込まれた関数の名前と同じものが ライブ 
ラリの 中にみつかっても，それは使用されない. 


後述する DEFF . CRL と DEFF 2. CRL のすベて関数の要約では，それぞれの 
間数が C プログラムの中で，どのようにして定義されるかということを， C - ラ 
イクな表記法で解説している.この表記法では，関数が値を戻すかどうか（も 
し戻すならば，どんなタイプのものか），また， I 対数が用いるパラメタのタイプ 
に関する情報を提供する.大ざっぱにいうと，関数がタイプなしに使用される 
場合，値を戻さない（たとえば， exit と £ oke は値を戻さない.多くの場合，低 


13) DEFF . CRL は， STDLIB 1. C と STDLIB 2. C からの C でかれた閱数のすべてを贪んでい 
る.一方， DEFF 2 .CRL は， DEFF 2 A . CSM , DEFF 2 B . CSM ， DEFF 2 C . CSM (CASM ファ 

シリティーを使用してアセンブルされている）のアセンブリ言捃閲数すべてを念んでいる. 

14) 必要とあれば，そこにすベてのライブラリ•ファイルをもっていなくても，どんなドライブ 
や 1 ー ザ ー 領域の中からでも，リンクは行われ，ユーザーは任意の CP / M ディスク•ドライブ 
とユーザー領域の中でライブラリ • ファイルを検索するために CLINK を設定してもよい. 



3.1 汎用関数 
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位 8 ビットのパラメタだけが使用され， char 型の値が関数へパスされるか，明 
白な宣言の欠けているパラメタは，常にタイプ int である. unsigned タイプの 
メモリー•ポインタカ、，文字ポインタかを区別するのは，ちょっとめんどうで 
ある.16ビットのメモリー•アドレス•パラメタの位置で char 変数をパスしよ 
うとしない限りは，パラメタの型宣言が コールし ているプログラムの中にある 
かどうかにかかわらず，事はうまく連ぶであろう. 

ライブラリ関数が C プログラムの中で使用される前に，それを実際に宣言す 
る必要のある場合がいくつかある. int 以外の値を返す関数が式の内部で使わ 
れているときがそうであり，その場合，その式を妥当な int 型以外のものにする 
必要がある（たとえば，ポインタ演算におけるように）.ある関数を宣言するこ 
とが妥当であるとき，あるいは不必要なときをはっきりさせるのに，ちょっと 
した経験が役に立つだろう：こういった決断の多くは，スタイルとポータビ 
リティ（移植性)，あるいはそのいずれかの問題である. 

DEFF . CRL と DEFF 2. CRL で有効な主な関数全部の要約について述べる. 


3.1 汎用関数 

char csw ^ ) 

は，コンソールスイッチ•レジスタ（いくつかのメインフレームでポート OxFF ) 

のバイト値 （ 0 — 255) を戻す. 


exit () 

は，オープンされているファイルをクローズし，実行プログラムを終了し， CP/M 
をリブートする.パ、ッファ付き出力のために，オープンされたファイルに対し 
ての fflush は自動的に行われない. 


int bdos ( c , de ) 
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は，まず値とを C レジスタに値也をレジスタ•ペアー DE にセットして，標準 
BDOS システムのエントリ•ポイント（ほとんどのシステムでは， ロケ ーショ 
ン0005 h ) を コールす る. BDOS から返ってくる値は，16ビット値で HL レジ 
スタに格納される. CP / M システムでは，レジスタに BDOS によってもどされ 
た A レジスタの値が， H レジスタには BDOS によって戻された B レジスタの値 
(8 ビットのリターン値ではゼロ）がそれぞれ格納される. CP / M でないシス 
テム（たとえば， SDOS など）との不適合な点についての詳しいことは，付録 
の”多方面にわたる注意点”を参照のこと. 

char bios ( n , c ) 

は，まずはじめに値上を BC レジスタにセットして， BIOS のジャンプべタト 
ル •テーブルの中の 丛 番目のエントリを コールする • ここで，上というのは最 

初のエントリ （ BOOT ) は0であり，2番目の （ WBOOT ) は1，3番目 （ CONST ) 
は2,……となる•リターン値は ， BIOS コール 終了後の A レジスタの値となる. 
コールド •ブート機能 （n が 〇)は実際には使用すべきではない.というのは， 
CCP はスタックによって消されているので，たぶん，システムをこわしてしま 
うだろうからである • DE の 中のパラメタを必要とし， HL の中にその結果を戻 
す BIOS コールが いくつかある.これらの コールの ためには， biosh 関数（次に 
説明する）を使用する. 

unsigned biosh ( n , dc , de ) 

は，まずはじめに値^^を BC レジスタへ，また値 de 

を DE レジスタへセットし， BIOS ジャンプ•ベタトル•テーブルの中の n 番目 
のエントリをコールする • 結果は， BIOS コールによつて HL レジスタの中に戻 
される値になる. 


char peek ( n ) • 

は，メモリー •ロケーション 2の内容を戻す.多くの連続的 ロケーションを 調 
ベる必要のあるような応用においては， oeek を使用するよりも文字ボイ ンタで 




3.1 汎用関数 


51 


間接的手段を用いた方がより効率的である.この関数は，ポインタを宣言した 
り，アドレスをそれに割り当てたり，単にアクセスするのに間接的手段，たと 
えば，単ーメモリ • ロケーシヨンを使用したりするのにはやつかいになるとき 
などの臨時の場合に使用する方がよい • 

poke ( n , b ) 

は， メモリー•ロケーション n に， b の 低位 8ビットを書き込む • これは， 


* n = b ; 

のように，ポインタを使用してより効果的に達成されうる.（ここで， n は文字 
ボインタである.） 

inp ( n ) 

ポート n から8ビットの値を取り出して戻す.メモリ ー マップされた入力機 
器のためには peek 関数を使用する. 

outp ( n , b ) 

は，8ビット値 b をポート！へ出力する.メモリーマップされた出力機器のた 
めには poke 関数を使用する. 


pausev ) 

は， CP/M のコンソール 入力があるまでループを回りつづける • しかし，入力 
された文字は，取り出されない. pause を再び使用する前に getchar によつてキ 
一入 力のステータスをタリアする必要がある•リ ターン 値はない • 


sleep ( n ) 

は， 4 MHz で n /20 秒の間， 2 MHz で n /10 秒の間，実行を停止する.ループが 
完結する前に打ち切る方法は，コントロール - C をタイプすることである•これ 
はプログラムを打ち切り，コマンド•レベルへ戻る.リターン値はない • 
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int call ( addr , a , h , b , a ) 

は，次のように CPU レジスタを セットし， ロケーション addr で 示される マシ 
ーン*コードのサブルーチンをコールする. 

HL < - _h ； 

A く 一 3 ; 

BC く 一 上； 

DE く 一 d ; 

リターン値はサブルーチンがレジスタ HL に格納した値となる.サブルーチ 
ンはもちろん，スタック規則を維持すること. 

char calla ( addr ， a , h , b , d ) 

は，サブルーチンによって戻された結果が （ HL のかわりに） A レジスタの値に 
なるということを除けば， call 聞数と同じである. 

int abs ( n ) 

は，の絶対値を戻す. 
int max ( nl , n 2) 

は， 2 つの格数値の大きい方を戻す. 


srand ( n ) 


il が0以外なら，この関数は，内部シード値をへセットすることによって 
疑似乩数生成器を初期化する. 2 がゼロなら， srand がユーザーがキャリッジ. 
リターンをタイプするよう に メッセージをプリントし，その間，内部で，シー 
ド値をカウント•アップし続ける • キーがユーザーによって打たれるとき，そ 
のカウントの現在値はランダムなシードを初期化するた めに， 使用される•ユ 
ー ザーのタイプした文字は失われ，ステータスはクリアされる. 



srandl ( string ) 
char * string ; 


3.1 汎用関数 
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は，前もって用意された” Hit return after a few seconds ”というメッセー 
ジのかわりに，与えられたストリングがプロンブトとして使用されるというこ 
とを除けば， Srand (0 U 同様である.しかし， Srand とちがって,そのプロン 
プトに答えて，ユーザーがタイプした文字は失われないので， getchar をコール 
してその文字をサンプルし，コンソールステータスをクリアする必要がある. 

int rand () 

は， Srand か Srandl によって初期化された疑似乱数順で，次の値（範囲： 0 
< rand ( ) <32768)を戻す. 0から n -1 の間の値を得るためには，次式 


rand ( ) % n 

を使用すればよい. 

nrand (-1, Sl ， S 2, S 3) 
nrand (0, prompt - string ) 
int nrand (1) 

これは，コーラント数理科学研究所で利用される. CDC 6600乱数生成器と競 
合するポール • ガンズ教授によって書かれた新しい，そして”より良い質”の 
乱数生成器である.初期化のメカニズムは， srand と srandl の規制との適合性 
のためにつけ加えられた.最初のフオームとは， SI , S 2, S 3 (int か unsigned ) 
によって指定された48ビットのデータと同じように内部の48ビット • シードを 
セットする.二番目のフォームは， srandl 関数と全く同じように作動する： 
Prompt - string によって示された文字列をコンソールにプリントし，それから， 
マシーンはコンスタントに内部の16ビット，カウンターを増加させながら，ユ 
ーザーからのキー入力を待つ.文字がタイプされるとすぐに，そのカウンター 
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の値は 48 ビットのシードへと変換される. コンソール 入力はクリアされないの 
で，その後に getchar コールして タイプされた文字を実際に取り出し， コンソ 
ー ルステータスを クリアすること を 行なう. 3 つめのフオームは 


0 く nrand (1) く 32768 
の範囲で，ランダムな値を戻す. 

nrand によって維持される内部シードは， srand , srandl , rand によって使用 
されるシードとは区別される.これは，ランタイムパッケージ•データ領域の 
範 M 内の rseed とラベルされた領域の最初の 32 ビットを使用する. Nrand はそ 
れ自身の明白な内部シードを維持する. 

setmen ( addr , count , byte ) 
char byte , 个 addr ; 

は， addr で始まるメモリーの一連のバイト数 count を値 byte へセットする•こ 
れは，配列とバッファ領域を早く初期化するのに効率的である. 

movemen ( source , dest , count ) 
char 平 source , ， dest : 

は， source アドレスから count バイトのブロックを dest アドレスへ動かす•こ 
の_数は，ブロック•ムーブを先頭から先頭までするか，末尾から末尾へする 
かを自動的に検知し，ソースと行き先の領域の構成を正しく操作する . Z 80 プロ 
セッサで実行している場合， Z 80 の”ブロック • ムーブ”命令が使用される. 
8080 か 8085 で実行している場合，普通の 8080 の命令が使用される.こういった 
ことは，すべて自動的に行われる. 


qsort ( base , nel , width , compar ) 
char * base ; 


int (* compar )()； 


3.1 汎用聞数 
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は， base から始まる width バイトの nel 個のデータを”シェル•ソート’’する. 
compar は，2つのアーギュメント（例えば， x ， y ) を比較する関数のポイン 
夕であり，.リターン値は次のようになる. 


もし* X > * y ならば 1 
もし* X く* y ，/ -1 

もし木 X == 木 y ” ( f > 

エレメントは，昇順でソートされる. 


int exec ( prog ) 
char * prog ; 

は，プログラム Prog . COM をチェイン（ロードし，実行）する. prog は，チ 
ェインされるためにファイルを指定する〇でくぎられたストリング•ポインタ 
でなければならない （" COM ” はネームで表わされる必要はない）.ストリング 
定数 （" foo ” など）は，ポインタとして扱われるので，使用可能である . exec 
されるプログラムが， C コンパイラによって生成され，それが外部変数を exec 
したプログラムと共有することが必要な場合，それは同じァドレスに共通外部 
データを配置するために， CLINK オプションー e を用いてリンクされている 
べきである • 一 e オプションの正しい使い方については， CLINK の説明書をみ 
よ . exec コールに よって，オープン•ファイルの 所有権が移ったり しない•こ 
の案のもとで唯一共有できる資源は，上記の外部データである. 

エラーのとき一1を戻すが，戻ってくるというのは，すなわエラーなのであ 
る. 


int execl ( prog , argl , arg 2, ., 0 ) 
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char * prog , * argl ,* arg 2,. 

は， argc と argv の メカニズムを 用いて，1つの C . COM ファイルから別のも 
のへとチェインする. prog は，チェインされる COM ファイルの名前を示す0 
で区切られたストリングでなければならない（” . COM ” は名前の中に現われ 
る必要はない）.各引数もまた0で区切られたストリングでなければならず，敁 
後の引数はゼロでなければならない. Execl は，与えられたパラメタから， コマ 
ンド 行をつくることによって作動する.また， ユーザーが CP / M の コマンド • 
プロセッサに，その コマンド 行をタイプしたように作動する.たとえば， 

execl (" foo ，，，” bar ，，，” zot ，，， 0); 

は， CP/M のコマンド行 


A > foo bar zot く cr > 

が接直タイプされるのと同じ意味を持つ.あいにく， CP / M 内部コマンド 
(" dir ”，" era ” などのように）は execl で呼び出されることはできない•与 
えられた文字例引数から，掲敉されたコマンド行全体の長さは，ほぼ80文字を 
越えてはならない.構成されたコマンド行が，この長さを越えた場合，その影 
骅のメッセージはコンソールにプリントされ，プログラムは打ち切られる.エ 
ラーのとき，一1が戻される（戻ってくる場合は，なんらかのエラーがあると思 
われる）. 


execv ( filename , argvector ) 
char * filename ; 
char * argvector []; 


この関数は，引数の変数を含めてチェインするようにする.ハ。ラメタ•テキ 
ストが，個別に指定されるかわりに，配列の中で指定されることを除けば , execl 
と同様である. argvector パラメタは，ストリング•ポインタの配列に対するポ 
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インタでなければならない.ここで，ストリング•ポインタは次の引数に対し 
てさし示し，また，最後のポインタのポインタ値は，0でなければならない（〇 
で区切られたストリングポインタではない）.リターンがあれば，それはエラー 
を意味しているのだが，エラーのときは， 一 1を戻す. 

int swapin ( filename , addr ) 
char 中 tilename ; 

は， filename で示される 0 で区切られたストリングで示されるファイルを，メ 
モリー ロケーション addr から ロードす る.フ アイ ルの大きさが，メモリ ー サイ 
ズより大きいかどうかは チェック されないので，どこで ユーザーが それを ロー 
ドす るのかに注意すること！たとえば，この関数は後の実行のために問接テ 
キ スト手段による オーバ、ー レイ •セグメントを関数へのポインタから ロードす 
るために使用される.ファイルを読み取っていると， エラーが あれば 一 1を戻 
す. コント ロールはロー ドされたファイ ルへ 移らない • 

char * codend () 

は，ルート.セグメントのプログラム • コードの末尾につづく最初のバイトの 
ボインタを戻す. CLINK の 一 e オプションカす，外部データを配厲するために使 
⑴されなければ，これはふつう，外部データ領域の始まりになるであろう（下 
記の externs 関数をみよ）. 

char * externs () 

は，外部データ領域の始まりのボインタを戻す •一 e オプションが CC と 
CLINK あるいはその一方で使用されたものでなければ，この値は， codend 関 
数によって戻されたものと同じものになる. 


char * endext () 


は，外部データ領域の末尾につづく最初のバイト•ポインタを戻す.これはそ 



58 第 3 な CP / M における BDS C 標，ライブラリ閱数 

の領域のスタートになり，そこから sbrk 関数は空きメモリーを得る. 


char 平 topofmen () 


は，ユーザー•メモリーの最後のバイトのポインタを戻す.これは普通，スタ 
ックのトップになり ， BDOS (— n オプションがリンク時に与えられない場合) 
のすぐ上か ， CCP (一 n がリンク時に使用される場合）のすぐ上のいずれかに 
ある • topofmem によつて戻された値は，リンク時の 一 t オプションの使用には 
影響されない. 

char * alloc ( n ) 


は，ポインタを長さ上バイトのメモリーのフリー•ブロックを戻す.あるいは， 
メモリーの n バイトが有効でない場合，〇を戻す.これは大体のところカーニ 
ンハン&リッチーの本の第8章からきている記憶割り付け機能であり，タイ 
プ位諝合わせの制限がないために电純化されている.詳しいことはその本を参 
照のこと.標準ヘッダーファイル BDSCIO . H は， alloc と free のペアを使用し 
ているプログラムのすべてのファイ ルの 中で，# include されていなければなら 
ない•というのは，その中で宣言された重要な外部データが いくつか あるから 
である. 


free ( allocptr ) 
char * allocptr ; 

は， alloc 関数によって割りつけられた メモ リーブ ロック を解放する. ここで 
allocptr は alloc に対する先の呼び出しによって得られた値である. Free は先 
の alloc 呼び出しの逆の順番でコールされる必要はない.というのは，リンクデ 
ータの構造は，割り付け除去のどんな順番も許容できるからである. a ll 0C の呼 
び出しによって，先に得られた値以外の引数を用いて f ree を呼び出してはいけ 
ない. 
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char * sbrk ( n ) 


これは，低レベルの記憶割り付け関数であり，メモリーを得るために alloc に 
よって使用される.これはパ、イトのメモリーのポインタを戻す.あるいは JL 
バイトが有効でなければ 一 1を戻す.最初の sbrk コールは，外部データの末尾 
のすぐ後につづく メモリーロケーションのポインタを戻す. sbrk は，割り付け 
られたロケーションが現在のスタック•ボインタの値に近くなるまで，その後 
の各々のコールが隣接する ブロ ックを戻し続ける."危険”な接近はデフォル 
卜では1000バイトと定義される.この値を変更するためには次の関数をみよ. 
プログラムの中で alloc と free の関数を使用することを計画しているか，ま 
た，スクラッチ.スペースに有効な割り付けからいくつかのメモリーを免除し 
たい場合， alloc のかわりに必要なメモリーを要求するために ， sbrk () を使 
⑴しなさい. sbrk コールはいつでも使用できる（すでになされた alloc と free 
コールとは無_係である）. 


rsvstk ( n ) 


この関数によって，記惚割り当て機能は，割り当てられた領域の末尾からス 
タック•ボインタの現在の値までの間の_〇_バイト以上の割り当てコールを拒否 
するようにする（そのスタックは，ハイ•メモリーより低くなることを忘れず 
に）. Rsvstk は, sbrk か alloc の呼び出しを行う前にコールされるべきである. 
rsvstk が使用されない場合，記惊割り当ては1000バイト以上，スタックに近づ 
かないように自動的に設定されている （"rsvstk (1000) ” コールがなされたか 
のように）. 

int setjmp ( buffer ) 
char buffer [ JBUFSIZE ] : 
longjmp ( buffer , val ) 
char buffer [ JBUFSIZE ] : 
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setjmp がコールされるとき，現在のプロセッサの状態は，与えられたバッフ 
ァの中にセーブされ（記号変数 JBUFSIZE は BDSCIO . H の中で定義される）， 
0の値が戻される.あとに続く longjmp コールが，現在の関数かあるいは，よ 
り低いレベルの関数のいずれかどこかにおいてなされるとき， CPU の状態は元 
の setjmp コールがなされたときにもっていたものに置き換わる.プログラム 
は元の setjmp コールへ”リターンする”ことによって実行を再開し，そのと 
き，値 vaKlongjmp にパスされたように）が戻される.プログラムが setjmp 初 
期化コールと处理の以降とを区別できるように， longjmp へパスする val の値 
はゼロ以外であるべきである. setjmp / longjmp の典型的な使い方としては，数 
レベルのネステイングされた関数から順#に各レベルを通してリターンする必 
要もなく，ネステイングを退出することである.たとえば，特殊な出ロルーチ 
ン（いうならば， DIO . C パッケージの dioflush ) がいつも行なわれることを確 
実にすることである. 


3.2 文字の入出力 

3.2.1 コンソール I / O を直接行う CIO 閫数パッケージ 

標準ライブラリで与えられた getchar と putchar の関数（後で説明されてい 
る）は，コンソールの絶対的なコントロールを認めない.かわりにそれらは， 
初期化や特殊な考えを要求せずに規則どおりの応用にとって最も有効であるよ 
うに設計されている.システムコンソールの装諝から受け取られる，また，そ 
こに送られるすべての文字に対して，完全なコントロールをできることが重要 
であるようなアプリケーションをつくる場合 ， BDS C V 1.50 パッケージ内の 
CIO 関数パッケージ （ CIO . CSM ) をアセンブルし，使用しなさい. CIO は，コ 
ンソール•インタフェースの特性を動的に抑制するための新しい ttymode だけ 
でなく， getchar ， putchar ， kbhit といった関数の代替版も含んでいる. 


int getchar {) 
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は，標準入カ ストリーム （ CP/M コンソール 入力） からの 次の文字を戻す •コ 
ントロ ー ル C が タイプ されると， CP / M をリブ ー トする.キヤリッジ •リター 
ンは CR - LF を コンソールへ 出力し， ニューライン r\n ，）記号を戻す •コ 
ントロール Z が入力されると値 一 1が戻される •リターン 値 一 1を整数として 
認識するには ， getchar からのリターン 値を整数として扱わなければな ら ない. 

(文字ではなく）かわりに， ユーザーが getchar を char 型の値を戻すように宣 
言する場合，あるいは，そのリターン値を文字変数へ割り当てる場合，値255は 
コントロール Z を検出するためにチェックされるべきである.しかし，この場 
合，実際のデータ値255と， EOF マーカーとを識別できないことに注意するこ 
と. 

char ungetch ( c ) 


は，文字 c が次の getchar の呼び出しによって戻されるようにする.連続的な 
getchar 呼び出しは，一つの文字だけしか”返せない”であろう.普通，ゼロが 
戻される.最後の getchar 呼び出しのとき， ungetch された文字がすでにあった 
としたら，その文字の値が戻される. 

int kbhit () 

標準入力があれば（キーボードが押された），真（ゼロ以外）を戻し，その他 
の場合は偽（ゼロ）を戻す.実際に入力が取り込まれることはない.それを行 
うには， getchar の呼び出しを必要とすることになる. ungetch 関数が最後の 
getchar の呼び出し以来，コンソールへ文字を押しもどすために使用された場 
合， kbhit もまた，真を戻すことに注意せよ. 


putchar ( c ) 
char c ; 


は，文字 c を標準出力 （ CP/M コンソール 出力）へ書き込む. ニューライン 
r\n ’） 記号は，出力のとき CR - LF の組み合わせへと拡張される. コント ロ 
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ール -C が putchar コールの 間に コンソールから 入力された場合， プログラムの 
実行は中止し， コントロールはコマンド•レベルへ 戻る.そして， ユーザーが 
コントロール C を タイ プ するこ とによって，コンソール 出力 （putchar コールに 
よって〉を行う プログラムを 打ち切られるようにする.与えられた putchar 関 
数は コンソールに 文字を出力し， コンソールからの 入力をチヱ ック するために 
BDOS を 使用するので，特別な CP/M フロー•コントロール記号（コントロー 
ル S ) が 認識され， putchar によってなされたプリ ント •アウト を 一時停止する 
のに 使用できる. 


putch ( c ) 
char c : 

出力の問， コント ロー ル C の入力をチェ ック しないことを除けば， putchar と 
同様で，割り込みを有するシステムでは， コンソール 出力の間，タイプ •アへ 
ッ ドを認める•もし，ユーザーがこの特徴を好み ， putch コールへ マップされた 
すべての putchar コールを 求めているなら， BDSCIO . H の ヘッダー フアイ ル 
のどこかに，次のプリプロセッサ命令を置けばよい. 


# define putchar putch 


そして，すべてのプログラムの中には，必ずヘッダーファイルを含んでいるよ 
うにしなさい. 


puts ( str ) 
char ^ str ; 

は，0で終結された文字列 str を標準出力へ書き出す.ニューラインは自動的に 
付加されない. 


int getline ( strour , maxllen ) 



char * strbuf ; 


3.2 文字の入出力 
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は， maxlen の文字数だけコンソールからテキストの入力を行う.リタ ー ン値は 
入力された行の文字数である.リターンのとき，入力行は NULL (0) によっての 
み終結される.だから空の行は，長さ0をもっていることになる（ユーザーが 
キャリッジ•リターン記号のみをタイプしたとき）.バッファの中には，ニュー 
ライン記号は戻されない.これは”カーニンハンとリッチー”で述べられた 
getline 関数からの偏差である. 

入力された文字の数が，与えられた最大数マイナス1に達する（終結する空 
白の余裕をとるため）場合，その行は完全と思われ，コントロールはキャリッ 
ジ.リターンがタイプされるのを待たずに，呼ばれたプログラムへすぐに戻る. 
これは BDOS フアンクション10がコンソール入力を読むのに使用されるから 
起こるのである. 


char 个 gets ( str ) 
char * str ; 

は，コンソールからの入力を，ロケーション str のメモリーからストアし 
NULL で終結しておく.入力行を終結するために，ューザーによってタイプさ 
れたニューラインは バッファへ コピーされない.ニューラインの前の文字は， 
終結する NULL の後にすぐ続けられる.リターン値は， str の始まりへのポイ 
ンタである.与えられた バッファの サイズは，終結する NULL のためにューザ 
一が入れられると思った最長のストリングよりも，少なくとも1バイト長くな 
ければならない. 

注意として，パ、ッファを大きくすることを推奨する.というのは，ここで才 
ー バーフローす ると， たぶんそのまわりの データ もほとんど破壊す るか もしれ 
ないからである.入れられた文字の数が135に達する場合，その行は終結したと 
思われる. 
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printf (format, argl，arg2, …） 
char * format; 

書式付きプリント関数で，出力は標準出力てある.標準バージョンでサボー 
卜される変換記号は： 


_d 

十進整数フォーマット 

U 

符号なしの整数フォーマット 

C 

単一文字 

S 

ストリング （ NULL で終結) 

0 

8 進フ オー マット 

X 

10進フオーマット 

各変換は， 



% [ — ] [[0] w ] [. n ] 変換文字〉 

というフォームでできている.ここで Iはフィールドの幅を指定し，殳（ある 
ならば）はストリング変換時の文字の最大数を指定する.Iのデフォルトの値 
は1である.左づめをさせるハイフンがパーセントサインの後につづけて指定 
されなければ，そのフィールドは右づめで出力される. y の値がゼロによって 
先行される場合，スペースのかわりに0がフィールドのパッドに使用される • 16 
進のァドレスをプリントするときなどに有用である . Bob Mathias の浮動小数 
点パッケージで使用される浮動小数点値のための e と f の書式変換を組み込ん 
だ printf は，ファイル FLOAT. C に含まれる. 

int scanf (format, aegl, arg2, …） 
char 木 format; 


赛式付き入力，これは printf に類似しているが，反対の操作をする. ％u 変 
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換は認識されないので，符号つきの，または符号なしの数字の入力の両方に％ 
d を使用すること.代入禁止文字 （*> は動作するが，フィールド幅仕様はサ 
ポートされない. scanf に対する引数は絶対にボインタでなければならな 


入力文字例（書式付き文字列での％ s 変換仕様によって示される）は，書武 
付き文字列の中の％ s に絞く文字が走査されるときだけ終結されることに注意 
すること • リターン値は，うまく割り当てられた項目の数である • scanf と 
printf についての詳しいことは，カーニンハン&リツチーの本の145〜150ぺ 
ージ（和文では158ページ）を参照せよ. 

3.3 文字列と文字の処理 


int isalpha ( c ) 
char c ; 

は，文字 C が アルファベット ならば真（ゼロ以外)，さもなければ偽（ゼロ）を 
戻す. 

int lsupper ( c ) 
char c ; 

文字三が人文字ならば典，さもなくば偽を戻す. 

int islower ( c ) 
char c ; 

記号 c が小文字ならば真，さもなくば偽を戻す. 


int isdigit ( c ) 
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char c ; 

記号 c が十進数ならば真，さもなくば偽を戻す. 

int toupper ( c ) 
char c ; 

上が小文字なら，上を大文字にしたものが戻される.さもなくばとが戻され 
る. 

int tolower ⑹ 
char c ; 

が大文字なら， i を小文字にしたものが戻される.さもなくば上が戻され 
る • 

int isspace ( c ) 
char c ; 

文字上が"ホワイト•スペース”（ブランク，タブかニューライン）なら真 
を戾す.さもなくば偽を戻す. 

sprintf ( string , iormat , argl , arg 2, •••} 
char * string , * format ; 

出力がコンソールのかわりに， string によってさし示されたメモリー•ロケー 
シヨンへ宵き込まれることを除けば， printf と同様である. 

int sscanr ( string , format , argl , arg 2, …） 



char * string , * format ; 


3.3 文字列と文字の処琛 
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テキストが，コンソールのキーボードのかわりに string によってさし示され 
た文字列から走査されることを除けば， scanf と同様である.うまく割り当てら 
れた項目の数を戻す引数は，割り当てを必要とする対象に対するボインタでな 
ければならないということを忘れずに. 

strcat ( si , s 2) 
char * sl ，* s 2; 

は， NULL で終結する文字列 si の末尾へ s 2 を連絡する.もちろん， si は，連 
絡できる十分な余裕がなければならない. 

int strcmp ( si , s 2) 
char * sl ，* s 2; 

( sl > s 2) の場合，正の値を， （ sl = s 2) の場合ゼロを， （ si く s 2) の場合 ft の 
値を戻す.標準 ASCII コードシーケンスが比較のために使用されるので，文字 
列がアルフアベット順でくるなら，それは"より大きく ”なる. 

strcpy ( si , s 2) 
char * sl ，* s 2; 

文字列 s 2 をロケーション si へコピーする.たとえば， foo と名付けられた文 
字配列を，文字列 barzot へ初期化するには， 

strcpy ( 100 , ” barzot ’’ ）； 

となる.正しい添え書なしで，配列名が値として使用されるべきでないので命 
令文 
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foo = ” barzot ’’ ； 

は正しくないということに注意せよ.また，式” barzot ’’ は文字列そのもので 
はなく” barzot ’’ に対するポインタを，その値としてもって いる. だから後の 
構造が作動するために， foo は配列としてでなく文字に対するポインタとして 
宣言されなければならない•だ 力す， このアプローチは危険である.というのは， 
foo の末尾に何かを付加するのに自然な方法は， 


strcat ( 100 ， " mumble ” ）； 

では，” barzot ，，につづく 6バイトをオーバーライトしている （"barzot ”が 
I 尚数のコード内で記憶されるときはいつでも）ので，たぶん，ひどい結果にな 
るだろう.可能な解決法が2つある.ユーザーは foo で割り当てられうる文字 
の一番大きな数を計算し，初期の割り当てを適切な数のブランクで埤め込む. 
たとえば， 

foo = "barzot ”） 
foo [6]= NULL ; 

あるいは， 

char work [200] ,* foo ; 

を用いて十分なサイズでの文字配列を宣言することができる.そのときは， 
foo = work ; 

と宣言することによって配列のポインターを foo にもたせる.また， 
strcpy ( foo ，" numble-fraz ’’ ）； 


を使用して foo を割り当てる. 



int strlen ( string ) 
char * string ; 


3.3 文字列と文字の処理 
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string の長さ （ NULL 記号を検出する前までの文字数）を戻す. 

int atoi ( string ) 
cnar * string ; 

ASCII ストリングをその一致する整数（あるいは符号なしの）値へ変換する. 
受け入れられるフォーマットは，いくつものホワイトスペースを（スペース， 
タブ•ニューライン）含んでいてもよい.そして，任意のマイナス•サインと， 
十進数の連続する文字列によって続けられる.最初の数字以外のものは走査を 
終結する.正当な値がみつけられなければゼロの値が戻される. 

initw ( array , string ) 
int * array ; 
char * string ; 

これは，整数配列の初期化を行うための関数である. Array は初期化される 
ために配列へさし示すべきである.また， string はコンマによって区切られた桉 
数値の ASCII ストリングへさし示すべきである.たとえば ， UNIX C の 

int values [5]= {-23, 0，1，34, 99 } ; 

は，次の文に取って替る. 
int values [5] ; 

また，どこか適切な場所に，命令文 

initw ( values ," 一 23, 0，1, 34, 99 ” ） ； 
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を挿入する. 

initb ( array , string ) 
char 个 array , 予 string ; 

は，文字配列のための前記の initw 関数の等価である. string は initw と间じフ 
オーマットのものである.しかし，各稀の低位8ビットが array の連続バイト 
へ割り当てるために使用される.この関数は，文字ポインターの配列を初期化 
するために使用されないことに注意しなさい.これは本当に，"文字”向きに 
できているのではないが，”文字”変数の列の中で値をもっている10進の整数 
向きにできていて，このようにして文字として記惊される. 

注意： UNIX C プログラムは，時々負の値を文字変数へ割り当てる. 
というのは ， UNIX C 文字変数は符号つきの8ビットの域であ 
る. BDSC では，記号変数は常に符号なしの値をもっていて，負 
の値は16ビットの int 変数へ意味深長に割り当てられるだけであ 
る. 


int getval ( strptr ) 
char 不 * strptr ; 

initw と initb からの副産物であり，コンマによって区切られた ascii 値の文 
卞列に対するポインターへ%ポインターを与えられている. getval は文字列の 
中でさし示された現在の値を戻し，次の値へとさし示すためにボインターを更 
新する（なぜ， strptr は記号に対する単ーポインターであることができないの 
か？⑸. 


15) なぜならば，文卞列内の文す•ポインターは， getval ルーチンによって変史されるからである. 
数によって变 It されるような侦は，その侦に対するボインターを通して操作されなければな 
らない.このように，”文字ポインター”は文字ポインターへのポインターを通して操作され 
なければならない. 
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終結バイト （0) を検出すると，一32760の値が戻される. Initw はこのよう 
に 一 32760の値を受け入れない.その値を使用する必要があるなら STDLIB.C 
内にある，終結する値を他の値へと変更しなさい（ユーザーは getval と initw 
も変更しなければならないだろう）. 

3.4 ファイル I/O 

3.4.1 BDS C のファイル入出力の閧数について 


BDS C ライブラリのファイル I/O _数は大きく分けて2つに分類される•原 
始（低レベルの）関数は1つのセクター•サイズを単位として，ディスクへデ 
ータを書いたり，ディスクからデータを読んだりする. パ、 ッファ付き I / O は1 
度に1バイトとか，1度テキストの1行といったようにユーザーが，より使い 
やすい大きさでデータを処理できるものである.低レベル関数が最初に述べら 
れ，次にバッファ付き関数を述べる. 

3.4.2 ファイルネーム 

閲数が引数としてファイルネームを用いるとき|ま，そのファイルネームはそ 
の値が文字式か，あるいは文字列のいずれかのポインターでなければならない. 
正しいファイルネームは大文字や小文字を含んでもよいが，文字列の中にホヮ 
イト.スペースがあってはいけない. 

3.4.2. 1ドライブ名 

ファイ ル ネームは，特別な CP / M ドライブを指定するために ，" d : ，，の 形 
式の任意のディ スク 名を指定できる.デフォルトは現在ログされたディ スタで 
ある.文字 d は， A から Z までの1文字のドライブ名である（ユーザーのシス 
テムの既存の論埋的装置に依存する）. 
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3.4.2.2 ユーザー領域 

1 /，，で表わされる任意のユーザー領域の指定もまたファイルネームの先 
頭に指定することができる.ここで，#は0から31までの範囲の十進数である • 
省略されている場合，現在のユーザー領域が指定されたとみなされる.ドライ 
ブ名とユーザー領域の指定の両方が与えられる場合，ユーザー領域の指定がま 
ず最初にならなければならない•たとえば，ドライブ C の領域7で 
" foobar . zot ” と指定されたファイルをオープンするためには， 

open (" 7/ c : foobar . zot ”， mode ); 

とする.ある奇妙な文字（コントロールコードのように）がフアイルネームの 
中で検知される場合は，ファイルネームは受け付けられなくて，エラー値が関 
数によって戻される.これは，その名前が印字抑制している文字をもつような 
ファイルをオープンすることによって起こる問題をいく分铎滅する•が，複雑 
な式などで，ファイルネームを構成するときは気をつけること. 

3.4.3 エラーの処理 

3.4.3.1 Errno/Errmsg 閣数 

BDS C の V 1.50 には，新しいファイル I/O のエラーの診断機能が組み込ま 
れている.エラーが起こったときはいつでも，一1 ( ERROR ) 値が問題の関数 
によって戻される.これが起こるときはいつでも，エラーについてのより詳し 
い情報を与える特別エラー•コード.ナンバーを戻すために errno 関数を呼び 
出せる. errno によって戻された値を errmsg 関数へ渡す場合， errmsg はどん 
なエラーが起こったのかを正確に説明する文字列のボインターを戻す.次にあ 
るのは，この機能の使い方の例である.これは， write 命令の間に起こるエラー 
を診断するものである. 


if (write ( fd , buffer , nsects )! = nsects ) { 
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printf (” Write error :% s\n ”， errmsg ( errno ()); 

… /* この他のリカバリー処理*/ 

} 

write 関数は， 一 1 ( ERROR ) が単なるエラーではない. write は書き込まれ 
たセクターの数を戻す.これはリターン値が普き込むように指示されたセクタ 
一の数に等しくない場合，エラーとみなされる • 

3.4.3. 2 ランダム • レコードのオーバーフロー 

oflow 閲数は，大きなファイルの読み取り/書き込みの際に才ーバーフローが 
発生したかを検知するためのものである.オーバーフローは，ユーザーがファ 
イル内の65535番目のセクターを過ぎて読み/書きしようとする場合に発生す 
る • 

3.4.4 原始ファイル I / O 閜数 


int open ( filename , mode ) 
char * filename ; 

もし， mode がゼロならば，ファイルは入力のために， mode が1ならば出力 
のために，そして mode が2ならば,入力と出力のためにオープンされる.リ 
ターン値はファイル記述子であり， 一 1ならばエラーである.ファイル記述子 
は， read ， write ， seek , tell , abort そして close で使用する • 

int creat ( filename ) 

char * filename ; - 

は，まず最初にその名前を持つ既存のファイルを削除し，与えられた名前を持 
つ空のファイルをつくり，新しいファイルは自動的に読みと書き込みの両方の 
ためにオープンされる.リターン値であるファイル記述子の値は read ， write , 
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seek, tell» fabort , close といった関数を使用するときに必要となる値一1 
が戻ってきたらエラーである. 

int close ( fd ) 

は， ファイル 記述子 fd によって指定されたフ ァイ ルを クローズし， 別の ファイ 
ルの使用のために fd を解放する.ディスク•アクセスは，書き込みのために才 
ープン された ファイルがクローズ されるときに起こるだけである. そのファイ 
ルが 読み取りのためにだけ オープン された場合， fd が解放されるが， ファイル 
を クローズす るための CP/M コールは 行なわれない. close は ノぐッファ 付き I/O 
ファイ ルのためには，使用されるべきではなく，かわりに， fclose を使用するこ 
と •エラーの ときは一 1 を戻す.すべての オープン された ファイルは main 関数 
から， ランタイム•パッケージへ 戾る際に，あるいは exit 関数が呼び出された 
ときに，自動的に クローズ される. オープン された ファイルがクローズ されな 
いようにするためには， fabort 関数を使用すること. 

int read ( fd , buf , nbl ) 

char * buf ; 

は，ファイル記述子 fd で指定されるファイルから， buf で指定されるメモリー 
の中へ nbl ブロック（各々128バイトの長さで）を読み込む.そのファイルと関 
連している r/w ポインターは，読み込まれたデータの直後に配罱される . read 
の関数の呼び出しで読み込まれるデータは，最後の read あるいは write 関数が 
読み/書き終えた場所から始まる. seek 関数は， r/w ポインターを変更するた 
めに使用される.リターン値は実際に読み込まれたブロックの数になり， EOF 
のときは0を，エラーのときには一1を戻す.ファイルの中で実際に残された 
のが上ブロックだけのときに，丑ブロックのデータを求める場合（ここで〇 く x 
く _5_)， read は x をそのリターン値とし，次の呼び出しのときには〇を戻し 
(seek は使用せず)，また，次に起こる呼び出しのときは 一 1を戻す. 



int write ( fd , buf , nbl ) 
chaer * buf ; 
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buf で始まるメモリーから nbl ブロックを， ファイル fd に書く. write の関数 
の 呼び出しで書き込まれるデータは， seek が r / w ボインターを変更するため 
に使用されなければ，最後の read か write の関数が読み/書き終えた地点から 
ひき絞いて始まる.致命的な エラーの ときは 一 1を戻す.あるいはリターン値 
がエラー （一 1) でなくても，うまく書かれた レコードの 数が nbl と異なる場合， 
それはたぶんディスクスペースを使い果たしたということを意味する.これは 
エラーと してみなされるべきである. 

int seek ( fd , offset , code ) 

は，ファイル fd に関連する r / w のレコード（セクター）ボイ ン ターを変更する • 
seek は code がゼロの場合， r / w ポインターをレコード offset へセットする. 
code が1の場合， r / w ポインターを現在の値プラス offset へセットする. ( off ¬ 
set は負でもよい）. code が2の場合は， r / w ポイ ン ターをファイルの終わりレ 
コードのナンバー，プラス offset へセットする.このタイプのシークでは， 
offset の値がファイルの中の既存のレコードへさし示されるために負でなけれ 
ばならない. code が2で， offset が0の場合， r / w ポインターはファイルに対 
してアペンドするために，準備される. 

リターン値一1は EOF ( code が2と同じ）からのシークの間に，ある種の 
BDOS のエラーが発生したことを示す. errno 関数は起こったエラーの種類に 
間して，より詳しい内容を与える • seek はバッファ付き I / O のためにオープン 
されたファイルに対して行なってはいけない. 

int tell ( fd ) 

は， fd に関連するファイルの r / w ボインターの値を戻す.この数は0から始ま 
り，ファイルへ書き込まれる，あるいはファイルから読み取られる次のセクタ 
一を示す. 
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int nulink ( mename ) 
char * filename ; 

は，フアイルシステムから指定されたファイルを削除する.注意深く使用する 



int rename ( old , new ) 
char * old , * new ; 

は，フアイルのリネーム（改名）を行う • rename で指定されるファイルは，才 
ニプンされていてはいけない • エラーのときは一1を戻す • 


int fabort ( fd ) 


は，ファイル記述子 fd をクローズせずに解放する.ファイルが読み込みのため 
だけに間かれた場合，ファイルには何も影驊はない.ファイルが書き込みのた 
めにオープンされた場合は，最後にオープンされてから現在オープンされてい 
るエクステントに対してなされた変更は無视される.しかし，他のエクステン 
卜でなされた変更はたぶん残る. ユーザーが 書き込んだ データの いくつかを失 
いたくなければ，書き込みのためにオープンされたファイルを fabart してはい 
けない • 


unsigned ctsize ( fd ) 


は，ファイルに関連する r / w ポインターに影饗せずに，正確なファイル•サイ 
ズ（セクターで）を計算する.ここで戻されたサイズは，ファイル•サイズを 
計算するのに使用される BDOS 機能 （35) とちがって，新しいエクステントが 
クローズされる前に，そのエタステントへ書かれたデータを戻す. 


int oflow ( fd ) 


与えられたオープン•フアイルに関連する FCB のランダムレコード•フィー 
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ルドの高位 （3 番目）のバイトからオーバーフローが検出されたなら，真 （0 
以外）を戻す. 

int errno () 

は，ファイル I / O 操作の最後に検知さ れたエラ ー 状態の コード • ナンバ、一を戻 
す.次のコードに 間係す る エラー メ ッ セージのリストを 参照せよ. 


char * errmsg (errnum) 


この関数は， errno によって戻されたエラー • レコードを基に，対応するエラ 
一•メ ッ セージのポインタを戻す . 


0 まだエラーは起こっていない No error occured yet 

1 宵かれていないデータの読み取り Reading unwritten data 


2 ディスクの容址不足 

3 現在のエクステントを閉じることができない 

4 杏かれていないエクステントへシークした 

5 新しいエタステントをつくることができない 

6 ディスタの末尾を過ぎて シークした 

7 悪いファイル記述子が与えられた 

8 ファイルが読み込みのために開かれていない 

9 ファイルが咨き込みのために開かれていない 
10 ファイル記述子の領域が残っていない 

11 ファイルがみつからない 
12 open に悪いモードが与えられている 
13 ファイルをつくることができない 
14 65535 番目のレコードを過ぎてシークした 


Disk Out oi space 
Can’t close current extent 
Seek to unwritten extent 
Can’t create new extent 
Seek past end of disk 
Bad file descriptor given 
File not open for read 
File not open for write 
No file descriptor slot left 
File not found 
Bad mode given to open 
Can’t ere ate nle 
Seek past 65535th record 


in setfeb (febaddr, filename) 
char febaddr [36]; 
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char ^ filename ; 

filename によって示された0で終結する名前を用いて，アドレス fcbaddr 
で配置レコード36バイトの CP / M ファイル•コントロールブロックを初期化す 
る.ファイルネーム文字列の中の小文字は大文字へ変換され，適切な数の空白 
は，ファイルネームと fcb の拡張フィールドの両方を埋め込むために生成され 
る • fcb の次のレコードとエタステント•ナンバーのフイールドは0にセットさ 
れる. 

ファイルネームの文字列の中で奇妙な記号（名前やファイル•コントロール， 
ブロックの拡張フィールドの中では，たいてい望ましくない種の）に出会うと， 
そのときは違反記号とそのファイルネームの残りは無視される. 


char * fcbaddr ( fd ) 


は，記述子 fd を持つオープン•ファイルと関連している内部の（たいてい目に 
みえない）ファイル•コントロール•ブロックのアドレスを戻す. fd がオープ 
ン • ファイルのファイル記述子でない場合，一1が戻される. 

3.4.5 バッファ付きファイル I / O 関数 

int fopen ( filename , iobuf ) 
char ゃ nlename ; 
struct buf * iobuf ; 

は，バッファ付き （1 回につき 1 つの情報）入力のために指定されたファイル 
をオープンする•そして， iobuf によって示されたバッファを初期化する . Iobuf 
は， パ、 ッファされた I / O ルーチンによる使用のために予約される BUFSIZ の 
値は BDS C の標準 I / O ヘッダーファイル （ BDSCIO . H ) によって決定される. 
バッファ付き I / O を使用しているバッファの構造体は， 
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struct _ buf { 

int _ fd ; 
int nleft ; 

char * nextp ; 
char flags ; 

char buff [N SECTS * SECSIZ ]; 


しかし，ユーザーにとって本当に問題なのは，それが BUFSIZ - バイト領域で 


char samplebuf [ BUFSIZ ] ; 


によって宣言されうる.ということである. 

リターン値は，オープンされたファイルのためのファイル記述子の番号であ 
る.これは，最初のエラーのテストの後にセーブされる必要はない.というの 
は，ファイル記述子の値が他のバッファ付き I/O 関数による使用のために， I/O 
バッファの中で自動的に維持されているからである.エラーのときは一1が戻 
される. 

int getc ( iobuf ) 
struct buf * iobuf ; 

は， fopen によって開かれた iobuf でバッファを持つバッファずみの入カファ 
イルから次のバイトを戻す.特別なコードは認識されない：コントロール Z 
はコントロール Z (—1でなく）として通る. CR と LF は普通の記号である. 
コンソールかリーダーから入力を行うためには，バッファされた入力機能を持 
つ iobuf 引数のかわりに0か3を使用する.” getc (0) ” は” getchar ( > ”と等 
しい，” getc ⑶”は， CP/M の”リーダー”から文字を読み取る • エラーのと 
き，あるいは物理的なファイルの終わりのときに一1が戻される. getc でテキ 
スト•ファイルを読み取っているとき，値 Oxla ( CPMEOF ) と普通の物理的なフ 
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ァイルの終わりの値 （一 1,か ERROR ) の両方は，ファイルの終わりを示すも 
のとしてみなされるべきである.というのは，ある CP / M のテキストエディタ 
はある状況のもとでは，テキスト•フアイルの末尾に Oxla (コントロール Z , 
CPMEOF ) バイトを普かないからである. 

ungetc ( c , iobuf ) 
char c ; 

struct buf * iobuf ; 

は， iobuf の人カバッファへ文字上を押し戻す.同じファイルでの次の getc の 
呼び出しは c を戻す.一度に一つ以上の記号は戻せない. 

int getw ( iobuf ) 
struct buf * iobuf ; 

getc への 2 回の連続した呼び出しによって， iobuf のところで，バッファを持 
つバッファ済みの入カファイルから，次の16ビットのワードを戻す.エラーの 
とき一1が戻される. 


int icreat ( filename , iobuf ) 
char ^ rilename ; 
struct _buf * iobuf ; 

は， filename で指定された ファイル （同じ名前によって既存の ファイル をまず 
削除して） をつ くる.そして， パ、 ッファ 付き出力のために ファイルを オープン 
する. Iobuf は BUFSIZE •バイ トの バッファを さし示すべきである.その ファ 
イ ルの ためのフアイ ル 記述子 fd を戻し， エラーの ときは 一 1を戻す • 


int putc ( c , iobuf ) 
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char c ; 

struct _buf * iobuf ; 

は， iobuf のところでバッファを持つ，バッファ付き出カファイルへバイト c を 
齊き込む.翻說はなされない：テキストの行は CR - LF の組み合わせ（標準 
CP / M ソフトウェアとの適合性のために），あるいは， UNIX ニューライン記号 
(効率性と率直さを増すために）のいずれかによって区別させることができる • 
iobuf のかわりに使用できる1から4までの値は，ファイルに対する出力のか 
わりに，標準出力，リスト装置，パンチ装鼢，標準エラー（コンソール）装厲 
に対して出力する. 

” putc ( c ，1) ，，は，” putchar ( c ) ” と等しい. 

” putc ( c , 2) ’’ は，文字を CP/M "リスト’’装置へ害き込む. 

” putc ( c , 3) ” は，文字を CP/M " パンチ”装置へ書き込む. 

” putc ( c , 4)” は，文字を標準エラー•ストリームに書き込む • これは CP/M 
のもとではいつもコンソール出力である•これは， I / O ダイ レク シヨンパッケー 
ジ （ DIO ) が使用され，標準出力がファイルへ命令されるような応用の中で，出 
力がコンソールへ行くことを保証するために使用される.ファイルへテキスト 
を杳き出した後，必ずコントロール Z ( Oxla ， COMEOF ) バイトを用いて 
テキストを終結させる.エラーのときは 一 1を戻す. 

int putw ( w , iobuf ) 
struct buf * iobuf ; 

は ， putc への 2 间 の 連絞した呼び出しによって ， iobuf のと ころで バッファ を持 
つバッファ 付きの出カ ファイルへ， 16 ビット•ヮー ド y を書き込む. エラーの 
とき， 一 1を戻す. 


int fflush ( iobuf ) 
struct buf * iobuf ; 
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は，出カバッファ iobuf をフラッシュする.これは出カ パ、ッ ファが，最後に埋ま 
ってから出カパ、ッファに書き込まれた文字が，デイスク上のファイルへ書き込 
まれたことを確認する（与えられたプログラムは exit ルーチンが，すべてのフ 
ァイルを閉じる前に中断しない）. Fflush はバッファされた Output ファイル 
(出力）を用いた使用のためのもので，入カファイルでそれを使用しようと試 
みても効果はない. 

出カファイルがクローズされるとき （ fclose 関数によって）だけでなく，出力 
バツフアがいつぱいになったときは，いつでも自動的に fflush が起こる • 


int rclose ( iobuf ) 
struct buf * iobuf ; 

指定されたバッファ付き I / O ファイル (( fopen による）読み取りか，あるい 
•は （ fcreat による）書き込みのいずれかのためにオープンされた）を クローズ 
する.ファイルが害き込みのために開かれたのなら，ファイルを閉じる前に自 
動的に fflush が出カバッファをフラッシュするために，呼び出される. 

注意： パ、 ッファされた出カファイルに対して書かれたテキストを持つ 
バッファ付きの出カファイルをクローズする前に，必ず， CP / M の 
"テキスト.ファイルの終わり ，，のマーカー （ CPMEOF ) をファ 
イルへ書き込むこと. 

int fpnntf ( iobuf , format , argl , arg 2, •••) 
struct _buf * iobuf ; 
char * format ; 

書式付き出力が， コンソール に対するかわりに， パ、ッ ファ 付き出カ ファイル 
に対して書かれることを除けば， printf と同様である•ェラーのときは一1を戻 
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int fscanf ( iobuf , format , argl , arg 2, …) 
struct buf * iobuf ; 
char * format ; 

テキスト入力が，コンソールからのかわりに，入カバツファ iobuf から走査さ 
れることを除けば， scanf と同様である. fscanf の今あるバージヨンは，データ 
の各行は完全に走査されることを求める.すべてのフォーマット仕様が満され 
た後に，ファイルから読まれた行の中の項目は拾てられる.うまく割り当てら 
れた項目の数を戻す.あるいは，ファイルを読んでいるときにエラーが起これ 
ば，一1を戻す. 

char * fgets ( str , iobuf ) 

char ^ str ; 

struct buf * iobuf ; 

指定されたバッファ付きの入カファイルから行を読み込み， str によってさ 
し示された位殷からのメモリーの中にそれをおく.これは， CP / M の規則がテ 
キスト•ラインの末尾に CR (キヤリッジ•リターン）と LF (ニューライン） 
の両方を持っているために扱いにくいものである. fgets は， C プログラムから 
処理する.テキストをより簡単にするために，ファイルに含まれている CR-LF 
の組み合わせから CR を自動的に取り除く. LF の後の CR 記号は手をつけず 
におかれる. LF は，文字列の一部分と して含まれる. そして，0が後につづく • 
読み込まれるラインの長さに関してはチェックはない•考えられる最長のライ 
ンを入れるために， str のところで十分な余裕があるかどうか確認するのに，十 
分な注意が必要である（ラインは完全であるとみなされる前に，ニューライン 
記号によって終結されなければならない）. EOF のとき，ゼロが戻される . EOF 
が物理的な EOF (ファイルの最後のセクタを通りすぎて読み取ろうと試みる） 
であっても，あるいは，ファイル中のコントロール Z ( CPMEOF ) 記号でも， 
ゼロが戻される.さもなくば，文字列に対するポインタ（パラメタ str と同様の） 
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が戻される. • 

int fputs ( str , iobuf ) 
char * str ; 
struct _buf * iobuf ; 

は， str のところのメモリーからの 0 で区切られた文字列を指定されたバッフ 
ア付きの出カフアイルへ書き込む. CP / M がうまく実行されるために，ニュー 
ライン記号は CR - LF 組合せへ変換される.ニューラインの前に，空白（ゼロバ 
イト）が文字列の中ではつけられる場合，出力時のラインに付加されたライン • 
ターミネイターはないであろう（部分的なラインを書くことが可能). 

3.5 DMA ビデオ • ボードのための作図関数 

set plot ( base , xsize , ysize ) 

は，プロセッサ•テクノロジー ( R . I . P ) の VDM -1のように，メモリー •マッ 
プ化された” DMA ” ビデオ•ボードの物理•的特徴（スターティング•ア ドレス， 
寸法）を定義する • Base は，ビデオ•メモリーの開始アドレスである • xs i ze は， 
デ イス プレイのラインの数である. y S i ze は，行の数である. Setplot は，プロ 
グラム次:行のスタート時に，一度呼び出すだけでよい.それから関数 clrplot ， 
plot ， txtplot ， line は与えられたパラメタを得て機能すふ 


clrplot () 


は，メモリー•マップされたビデオ•スクリーンをクリアする（空白でうめる） 

plot ( x , y , chr ) 
char * chr ; 


は，ビデオ•スクリーン上の座標 （ X , y ) に文字 chr を書く.（ X , y ) は， down , 
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across と読まれる.ここで 

0 く = x く xsize ， 

0 く = y く ysize , 

の値でなければならない. 

txtplot ( string , x , y , ropt ) 
char * string ; 

は， スクリーン 上の （ x , y ) の位誇から， ASCII 文字列を害く. ropt がゼロ以 
外のものなら，文字列の各バイトは，表示される前に値 0 x 80 でもって，論埋的 
に OR される.これは高位ビツトを1にすることにより， （ VDM -1 のようなボ 
ー ドでの）反転文字が出力されるようにする.あるいは，他の いくつかの ボー 
ドでは，おかしなでたらめな表示をする. 

line ( c , xl , yl , x 2, y 2) 

この関数は，ポイント （ xl , yl ) と （ x 2, y 2) の間に，曲線 （64 X 16 の画面サ 
イズでは，まっすぐにみえる線をつくる方法はないからである！）を引く. 

そのラインは， 記号 c でで きている. Line は，64 x 16の画面サイズでしか作 
動し ない. 
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第 4 章 

"The C programming Language ” の付録 A に関する註釈 


4.1 序 

BDSC は， UNIX のサブセットである.ゆえに ， C リファレンス •マニユア 
ルのほとんどの部分は ， BDS C に庚接適応する.この付録の目的は ， BDS C が 
その文害に従わないセク ションに 註釈をつけることである. 

2つの コンパイラ 間の相違に ついて， 一般的に要約した後，その文害からの 
適切な セクションのナンバーを 参照し，また ， BDS C がそこで説明され ている 
こととどう違うのかを説明す る ことによって （BDS C に関して）より詳しく述 
ベる • 

次にあげるのは ， UNIX C と BDS C の最も重要な偏差の要約である. 

1. 全ソース•ファイルは，ウインドウを通してパスされるかわりに，すぐ 
にメモリーへ^ロードされる.これは，有効なメモリーサイズに対して単一 
ソース • ファイルの最大の長さを制限する. 

2. コンパイラは，中間アセンブリ言語ファイルを作らずに，8080マシーン • 
コードを直接生成する. 

3. BDS C は， C 言語ではなく，8080ァセンブラ言語で書かれて いる. BDS 
C がそれ自身を用いて書かれた場合，そのコンパイラは，何倍も大きくなる 
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だろうし，現在のスピードと同じ速さで実行しない.我々はここで8080コ 
ー ドを取り扱っているのであって， UNIX のように PDP -11 コードではな 
いことを憶えておいてほしい. 

4. 変数タイプ ， short int , long int , float , double はサポートされない. 

5. 明白に宣言できる記惊クラスはない. static と resister の変数は存在し 
ない.すべての変数は， external か automatic かのいずれかであり，それ 
らは宣言された文脈によって決まる. 

6. 宣言の複雑さは，ある ルールに よって規制される. 

7. 初期化は，サポートされない. 

8. 文字列の記憶割り当ては，明白に操作されなければならない（自動割り 
当て/不要部分の整理のメカニズムはない）. 


4.2 付録 A に対する註釈 


次は， C リ フアレンス•マニュアル 16 ) に対する セクション ごとの註釈である • 
簡潔にするために，上にあげたいくつかの項目は再び示されない.本の中でみ 
つけられる. float 浮動小数点, long 倍精度整数, static 静的変数 , initialization 
初期化などに対する参照は無視されるべきである. 

1. はじめに 

BDS C は， CP/M OS を備えた8080 マイクロ コンピュータシステムのために 
デザインされていて，与えられた C ソース.プログラムから直接8080二進のマ 
シーン •コードを （特別な再配置可能フォーマットで）生成する.当然 BDSC 
は， Z 80 あるいは8085のように，8080とかなり適合するプロセッサでも実行され 
うる. 


16> ”C projframming Language ••の本の付録 A 
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2.1 コメント（註釈） 

コメントは，デフォルトで入れ子が可能である . BDS C のプロセッサのコメ 
ントを UNIX C が行う方法にするために，二^オプシヨンをコンパイラ CC へ 
与えられなければならない. 

2.2 »別子（名前） 

人文字，小文字は変数，構造体，共有体， ftd 列名では区別されている（異な 
る）が，関数名はこの限りではない 17 関数名は混乱をさけるために，単一の文 
字型（大文字か小文字のいずれか）で書かれるべきである.たとえば命令文 

char ioo , roo , FoO ; 

は，異なる名前を持つ3つの文字型変数を宣言する.しかし，2つの式 

printf (” This is a test ” ）； と 
prINTf (” This is a test ”）； 

は，等しい. 

2.3 キーワード 
BDS C のキーワード： 


int 

else 

char 

for 

struct 

do 

union 

while 

unsigned 

switch 


i 7) 閿数名は，内部で大文卞として紀 te される. 
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goto 

case 

return 

default 

break 

sizeof 

continue 

begin 

if 

end _ 

register 

void 


キーワードの場合，大文字，小文字の区別は無視される.たとえば ， WHILE 
は while に等しい. 

キーワードは，識別子（たとえば charflag ) の中に含まれることはできるが, 
キーワードと同じ名前を持つ識別子は認められない. 

左右のカーリー•ブレイブス記号{と}をサポートしない端末装置では，キ 
ーワード begin と end が取ってかわる.これらの識別子を持つことはできな 
い. というのは，これらは コンパイ ラによってキーワードと認識されるからで 
ある. 

4. 名前には何があるか？ 

external と， automatic という2つの記憶クラスがあるだけだが，それらは 
明白に宣言されない.識別子が宣言されているような文脈は，いつもその識別 
子が外部のものであるか，あるいは自動的であるかどうかを決定するのに，十 
分な情報を与える._数の定義の外側に現われる宣言は明らかに外部のもので 
あり，関数定義の範關内でのすべての変数の宣言は自動的である. 

自動変数は，宣言のポイントから現在の_数定義の末尾まで，語意の有効範 
I 用を持って いる. 単一の識別子は，与えられた関数内で2回以上宣言され るこ 
とはない.これが意味するのは，局所の構造体メンバーや構造体タグは，局所 
変数と同じ名前（またはその逆）を持つことができない.特別なケースについ 
てよサブセクシヨン11.1をみなさい. 

BDSC では，関数の中に blocks の概念はない.複合文の最初に，局所変数 
を定義することができるが，それは後に宣言された局所自動変数と同じ名前を 
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持つことはない.また，その語意の有効範囲は，複合文の末尾を通りすぎて， 
関数の末尾に至るまでずっと続く. 

すべての自動変数宣言は，関数定義の始まりに制限され，他の複合文の先頭 
で変数を宣言する実行は避けられるようにすることを強くすすめる. 

いくつかのファイルが，1つのセットになった共通外部変数を共有している 
場合，すべての外部変数宣言は，関連する 18 >ファイルの各々 の 範囲内で，等しく 
命令されなければなら ない . BDS C における外部変数のメカ ニ ズムは FOR - 
TRAN の ラベル無し COMMOM 文と，ほとんど同じように操作される•たと 
えば，他のファイルが a , b ， c だけを 使っていて，ユーザーの main ソー ス- 
ファイルが外部変数 a ， b ， c ， d , e を順に宣言する場合，2番目のファイ 
ルは， d , e を宣言する必要は ない. 一方，2番目のファイルが， a , b , c 
でなくて， a と e を使用した場合， d と e ( 2番目のファイルから）が a と b 

(最初のファイルから）とオーバーラップしないように，また，大きなトラブ 
ルを起こさないように，変数のすべてが宣言されなければならない.加えて不 
便なことに，その ソース • ファイルがそれらすベての外部変数を使っているか 
いないかにかかわらず，” main ”関数を含む ソース •ファイルの範 M 内で宣言 
されなければならない. 

すべての 共通外部宣言が，単一の” h ”ファイルの中でキープされる限り， 
また# include が” H ”フアイルを読み取るように，プログラムの各 ソース •フ 
ァイル内で使用される限り，トラブルが起こることはない.いずれにしても比 
較的少なければならない. 

6.1 文字と整数 

BDSC では，符号拡張は行われない.文字は〇〜255の範 I 相で8ビットの符 
号なしの値として解釈される. 


i 8> このような場合に，すすめられる方法は，すべての共通外部変数 a 言を含む単ーファイルを 
中®することである.そのファイルは，拡張名 .H (”ヘッダー，’）を持っているべきで，各ソ 
ース•ファイルの先頭で# include プリプロセッサを使用して,指示されるべき である. 
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BDSC では， CHAR 変数は負の値を持つことはできない. 

get c のような関数のリターン値をテストするは，注意しなさい.これは，エ 
ラーのときは普通”文字”でなくて -1 を戻す.実際，リターン値は get c のリ 
ターン値を文字変数へ割り当てる場合，一1の値は8ビットの記惊セルでは255 
へとかわる.そして，一1と等しいかをみるために，文字をテストしても真を戻 
さない•こういった状況のときには注意しなさい. 

文字でのほとんどの演算は，その文字を高位バイトに0を持つ16ビットの数 
へと変換することによって達成される.割り当て式のように，非演算操作にお 
いては，バイトだけを基準にしている char 値を処理することによって，コード 
生成を般適化する.これを利用するために， char 変数として0〜255の範网でと 
どまると，ューザーが信用している変数を宣言しなさい. 

7. 式 

ゼロによる除?？■•とゼロによる mod は，両方ともゼロの値になる.この場合, 
どんなエラーも発生しない. 

7.1 基本式 

_数呼び出しの中の パラメタの 評価の順は，逆になる.たとえば，最後の パ 
ラメタが，最初に評価され，スタック上でプッシュされる.それから，最後か 
ら2番目のが評価され，スタック上にプッシュされる，というように.これは， 
パラメタが呼ばれている関数に対して上向きの順で現われるように行われる. 
また，パラメタの有効数を関数が取るようにするためもである. 

7.2 単項演算子 

演算子 

(型指定子）式 
sizeof (型指定子） 

は，実施されない. sizeof 演算子は式が配列でないように与えられた 
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sizeof ^ 

# 

というフォームの中で使用される sizeof を配列と取るには，その配列はその 
sizeof を取られる構造体として認めて，その配列自身によって，構造体の中へす 
ベて配置されなければならない•もう一つの可能性は， sizeof を配列の中の単一 
エレメントとしてとることである.それから，それを配列全部のサイズを生み 
出すために，配列の中のエレメントの数で掛けることである. 

7.5 シフト潢算子 

操作 >> はいつも論理的 （0 で埋める）である. 

7.11.7.12 論理的 AND と OR 演算子 

BDS C では2つの演算子&&と丨丨は，等しい優先順位を持ち，それが 
UNIX C のもとでないような場合には，かっこを必要とする •&& と丨丨の複 
雑な組み合わせを含む式は，いずれにしても基本的には，混み入ったものにな 
る.また一般的な主義として，かっこを使用するべきである. 

8. 宜首 

宣言は， フォーム： 

型指定子 宣言リスト 

を持つ."記憶クラス”指定詞はない. 

8.1 記憶クラス指定詞 

実施されない. 

8.2 型指定詞 

型指定子： 
char 
int 
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unsigned 

resister 

struct または union 指定子 
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resister 型は，変更子（たとえば ， register unsigned foo ;) として使用され 
ないならば， int と同義語と思われる.この場合，完全にそれは無視される. 

キーワード void は， int と同義語として扱われ，関数が値を戻さない事実を文 
書証明するために使用される.他に認められている"形容詞”はない. 

unsigned int foo ; は， 
unsigned 100 ; 


として書かれなければならない. 

8.3 宜言子 

初期化は認められない.ゆえに，宣言子リストの構文は次のようになる. 
宣言リスト： 

宣言子 

宣言子，宣言子リスト 

8.4 宜言子の意味 

UNIX C は，任意の複雑な型の組み合わせを認められているし， 


struct foo *(* (* bar [3] L 31[3]())(); 


ここでは ， bar 3 x 3 x 3の配列のポインタが関数のアドレスをさし，その関 
数の返すボインタが関数のアドレスを示し，それが返すポインタタイプ foo の 
構造をさ している. 

いずれにせよ ， BDS C はそういった特殊な宣言を認めないだろう. 

まず，単純型指定が 
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char 

int 

unsigned struct 

union 


によって定義されるようにし，それから， 

スカラ型指定： 

simple-type 
pointer - to-scalar - type 
pointer - to-runction 

によって，スカラ型が定義されるようにすること. 

確定的なスカラ型である関数へのボインタはそれに割り当てられた関数のア 
ドレスを持ち，その関数を（正しい構文を用いて）コールするために使用され 
る変数である . BDS C がこういったものを内部で操作する方法のために，関数 
へのポインタの変数に対するポインタは，正しく作動しない.しかし，他のス 
カラ型（構造体，共有体，関数へのポインタを除く）を戻す関数に対するボイ 
ンタは 0 K である. 

今までのところ，スカラ型は， 

int x , y ; 
char * x ; 
unsigned ホ fraz ; 
char * * argv ; 
struct foobar * zot , bar ; 
int *(* ihtfp )(); 

といった宣言をカバーする. 

(上記の例の最後のものは， ihtfp ポインタを，整数を戻す関数に対する 
ポインタであるように宣言する.） • 
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スカラ型の概念をつくり，我々は配列がスカラ型の目的の一次元あるいは二 
次元のコレクション（関数へのボインタの変数を含む）であるように定義する. 
今，我々は， 


char * x [5][10] ; 
int * * foo [10]; 
struct steph bar [20][8] : 
union joyce * ohboy [747]; 
int * (foobar [10] > (); 

といった構成を持ちうる. 

(上記の例の最後のものは， foobar が整数を戻す関数に対する10のボイ 
ンタをつくり上げている配列であるように宣言する.） 

次に，我々は関数が関数へのポインタ，構造体，共有体以外のスカラ型を戻 
すことを認めている（構造体と共有体に対するボインタは除外しない）. 

もっと例をあげると， 

char * bar (); 

は， bar が文字ポインタを戻す関数であることを宣言する. 
char *(* bar )(); 

は， bar がポインタを戻す関数に対するボインタになることを宣言する. 


char *(* bar [3][2] )(); 


は， bar が文字ボインタを戻す関数に対する個々のボインタの3 x 2の配列で 
あることを宣言する. 


struct foo aot (); 


は， aot がタイプ foo の構造体を戻す関数であるように宣言しようとする.関数 
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は構造体を戻すことはできないので，これは予知できない結果を生むだろう. 
struct * foo zot (); 

は， OK である • aot は，タイプ foo の構造体のボインタを戻すものとして宣言 
される. 

BDS C の1つの重大は”悪い特徴”は，明白な配列へのポインタは宣言す 
ることができないことである.いいかえれば， 

char (* foo ) [5] ; 

のような宣言は， foo が配列に対するポインタになることを宣言するときはう 
まくいかない . BDS C コンパイラ（そしてそのプログラマーも）が比較的単純 
なところがあるために，先行宣言は， 

char * foo [5] ; 

と同じ意味を持って終わる. 

より楽観してみると，配列として宣言された関数のパラメタは，"配列への 
ポインタ”として内部で操作され，適切な配列識別子が式の中で使用されると 
きはいつでも自動的な関数的手段が取られるといったことをひき起こす.これ 
は，関数に対して pi と同じ位かんたんにパスする配列をつくる.このメカニズ 
ムの 多方面にわたる例のために ， BDS C パッケージの いくつかの バージョン 
に含まれる Othello プログラムを調べなさい （ C ユーザーズ•グループでいつも 
手に入る）. 

8.5 構造体と共有体の宜曾 

”ビット •フイ ールド”は実施されない.我々が持っているのは，次のとおり 
である. 

struct - or - union - specifier : 

struct - or-union { struct - decl - list } 
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struct - or-union identifier { struct - ded - list } 
struct - or-umon identiiier 


struct - or-union 

struct 

union 


struct - ded - list : 

struct-declaration 
struct-declaration struct - ded-list 


struct - declaration : 

type-specifier aeclarator - list ; 


declarator - list : 

declarator 

declartor , declarator-list 


構造体定義の中のメンバーとタグの名前は，他の局所識別子の名前と同じで 
あってはならない.（一つの_数につき〉一つ以上の構造体あるいは共有体がメ 
ン バーとして与えられた識別子を使用できるのは，すべての場合が同じタイプ 
とオフ セツ トを持つときだけである.サブ セクション li . i をみなさい. 

8.6 初期化 

申し訳ないが，初期化は認められていない. 

すべての外部変数は，自動的にゼロへ初期化される.（これは，1.50以前のコ 
ンパイラの場合は，そうでないことに注意しなさい.） 
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8 .7.8. 8 型名 ， Typedef 

BDSC に適応しない. typedef は実施されない • 

9.2 複文，すなわちブロック 

BDS C には ブロック はない.変数は ブロック に対して ローカル なように宣 
言されない.関数の中のどこででも現われる宣言は，その関数の終わりまでそ 
の効力は残る. 

9.6 For 文 

本省は少しごたごたしている（本書が ユーザーを 混乱させてなかったら，次 
にはっきり述べていることは，きっといいでしょう…） 
for 命令文は，説明されたように完全に while 命令文と等しくはない.という 
のは， continue 命令文は， for ループの命令文の部分を実行している問に出会う 
すべてであるなら ，コン ト ロールは 式3にパスするだろう•だが while バージヨ 
ン においては ， continue はコン ト ロールが 直接ループのテスト部分にパスする 
ようにする.また，その特殊な繰り返しの間は，式3を実行しない.一方，セ 
クシヨン 9. 9で与えられた表示は正しい.なぜならば，増加は明白に書かれるの 
でなくて，暗にほのめかされる （ contin : で起こると）からである. 

これは単なる文書提示における矛盾である . UNIX C コンパイラ（私の知る 
限りでは）と BDS C コンパイラの両方が for のケースを正しく操作する. 

9.7 switch 文 

一つのスウイッチ構成につき，200以上の case 文を指定できない • 

複数の case 文は各々，1として数えることに注意しなさい.だから命令文， 

case ’ a ’ ： case ’ b ’ ： case * c ’ ： printf ( ” a or b or c ” ） 


は， 3 つの case と数える. 
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9.12 名礼付き文 

case あるいは default に直接つづくラベルは認められない • そのラベルは最 
初に書かれるべきであり，それから case か default のキーワードによつて続け 
られる.例えば， 

case f x ’ ： mumble : zap = fritz ; 

は正しくない. 


munble:case * x ’ :zap = frotz ; 

へ変更されるべきである. 

10 外部定義 

型指定子は，関数定義（デフォルトは int である）を除いたすべての場合に明 
白に与えられなければならない. 

11.1 構文範囲 

構造体や共有体の範 M 内でのメンバーとタグは，宣言された識^子の他の夕 
イプに等しい名前を与えられるべきでない . BDS C は単一識別子が1回に 一 
つ以上のことに使用されるのを認めない（局所識別子が類似した名のついた外 
部識別子を一時的におおっているときを除く）.これが意味しているのは， 

struct foo { / * define struct of type M foo M * / 

int a ; 
char b ; 

} foo [10] ; /* define array named ” foo ’’ made up 

of structures of type ’* foo ” * / 
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のような宣言を書くことはできないということである.これは，たとえ UNIX 
C がこういったものを許しているとしても，結果的には混乱するし，いずれにし 
ても使用されるべきでない. 

このルールには，1つの例外があり，構造体メンバーを含んでいる. コンパ 
イラは， 1) タイプと 2) 記憶オフセット（その構造体がベースから）が両方の 
場合で，同一である限り異なる.構造体の定義の範囲でメンバーと同じように， 
使用されている識別子を黙認する.たとえば，次のものはこの許容されている 
方法で識別子 " cptr ”を使用する. 

struct foo { 
int a ; 
char b ; 

char * cptr ; / * type : char * ， offset : 3 * / 

}; 

struct bar { 
unsigned aa ; 
char xyz ; 

char * cptr ; /* type : char *, offset :3 */ 


11.2 外部定義の範囲 

extern のキーワードはない.すべての外部変数は，ファイルのサブセットを 
使用する.各ファイルの範囲内で同じ順で正しく宣言されなければならない. 
また，プログラムの中で使用されるすべての外部変数は，，， main ” 関数を含む 
ソースファイルの範_内で宣言されなければならない. 

次にあげるのは，外部定義が普通どのようにして操作されるかである：ラ 
ンタイム•パッケージのロケーション0015 h (たいていメモリー•ロケーション 

0115 h ) は外部変数領域のベースに対するポインタを含んでいるすべての外部 
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変数は，このポインタ 19> に索引をつけることによってアクセスされる.全プログ 
ラムのための外部データ領域は，" main "ソース•ファイルで定義されたすベ 
ての外部データによって必要とされるスペースに等しいように CLINK によっ 
て仮定される.外部記憶あるいは，外部名に関して CRL ファイルの 範囲 内で 
は，情報は記録されないので（関連するバイトのトータル数以外，そして任意 
に外部の明白なスタート•アドレス），各ソース•ファイルが，外部宣言の同一 
のリストを含んでいることを確認するのは，ユーザーの貞任になる.名前は， 
別々のファイルの中で各々符号する外部変数のために，必ず同一である必要は 
ないけれど，型と記憶クラスは，混同をさけるために必ず一致しているべきで 
ある. 

BDS C の外部変数を，一つの大きな FORTRAN のような COMMON ブロ 
ックとみなしても，見当はずれということもないだろう. 

注意： ライブラリ関数 alloc と free を使用する場合， ユーザーは プロ 
グラムの中にヘッダーファイル BDSCIO.H を含んでなければな 
らない.というのは， BDSCIO.H の中で宣言された alloc と free 
の必要とする外部データがいくつかなければならないからであ 
る.また，外部変数を持つソース•ファイルの 範 M 内でこういった 
宣言を省くと，望ましくないデータ • ォーバーラップを引き起こ 
す. 

12.1 提りの置換 

# define プリ プロセ ッサの命令のすべての フォームは サ ポー トされて いる. 
パラメタ化された定義を含んで いる. 再帰的（互いに参照する）にパラメタ化 
された# define 操作は検知されない.もしそれ を やってみると，ス トリ ングの才 
ーバー.フローを 引き起こす. 


19) CC に対する 一 e xxxx オプションは，絶対的なロケーション xxxx で外部変数領域を位沢 
衍定するために使用される.それによって，かなりスピードがアップし，コンパイラのつくり 
出すコードを短かくする.それでもすべての宣 H 制約条件は，依然として守られなければなら 
ない. 
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12.2 ファイルの 包含 

二重引用符が，ファイルネームを区切るために使用されていて（たとえば， 

# include " filename ”のように），明白なドライブあるいは，ユーザー領域の指 
示子が，ファイルネームに先行して現われた場合，そのファイルは現在のディ 
レクトリだけの中で常駐していると思われ，ファイルがそこになければコンパ 
イル作業は打ち切られるだろう.アングル•ブラケット （# include く filename 〉 
のように）が使用されている場合，デフオルトのディスクのドライブユーザー 
領域のみ（第1章でのべられたように）が検索される. 

含まれているファイルがすでにロー ドされてしまった後に，条件つきのコン 
パイル命令が後のパスで処理されるだけである.一方# include 命令は，ソー 
ス • ファイルがディスタから読まれるときに，オン•ザ • フライで処理される 
ということに注意しなさい.それゆえに，コンパイラは，その条件を偽と評価 
したときでも，条件つきコンパイル • ブロックの範油内で配3?された# include 
命令を処理しようとする. 

すべての# include 命令がみつかる限り，事は正しく連ぶ.というのは，その 
条件が処理されるとき，適切なコードはただ後になって無視されるだろうから. 
しかし，もし，# include 命令によって指定されたファイルがみつからない場合， 
CC は エラーを プリントし，コンパイルを打ち切る. 

ファイル包含は，適度な深さに入れ子にされうるが，エラー•リポートは， 
ネスティングのレベルだけを認識する.何が起こるかを正しく知るために，包 
含ネスティングのレベルを変史し， CC の”一 p ”オプションを用いて，実験し 
てみるとよい. 

12.3 条件付き コンパイル 

すべての標準条件付き コンパイル 命令は，サポートされるが ， #if く expr > 命 
令によって取られた式は次の構文に限られる： 
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く式〉：=く式2> または， 

く式2> && く式〉 または， 

く式 2> II く式〉 

く式2> : = く10進定数〉 または， 

! く式2> または， 

(く 式〉） 


く10進定数〉は，シンボリックである （# define の; S 換が完成した後に，平易 
な10進定数を産む）.しかし， # if プロセッサによって，論理的侦として，いつ 
も取り扱われる.つまり，0の値は偽であり，その他の値は具である.条件付 
き コンパイル 命令のネス テイ ングは，十分サボートされて いる. 

12.4 行制御 

実施されない. 

15.0 定数式 

BDS C は，定数式が次のキーワード，左スクェアー•ブラケット （[),CASE 
キーワード，割り当て演算（ = >， コンマ， 左ペア レン セス （ ])， return キーワ 
ードのうちの 一つの すぐ後に現われるときだけ， コンパイル 時に定数式を単純 
化する.これらのキーワードのうちの 一つにつづかない 定数式は， コンパイル 
時に単純化されないことを保証されている. 

定数式の コンパイル 時の評価を確実にするための標準的な手順は，定数以外 
の ェレメント を含むより大きな式の中に含まれているとき，特にかっこの中に 
定数式を置くことである.このように， 

x = x + y + 15 * 10; 

のような命令文は申.純化されない（これは10と15を掛けるためのコードをコ 
ンパイルに 生成させる）.また，一般的に， 
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x = x + y + (5 * 10); 

というようなより良いフォーム，よりも長くてスローなコードを生む. 

定数と定数式でのすべての乗算計算は，符号なしのオペレーションとして 
なされる. 

18.1 式 

単純演算子は，次のとぉりである. 

*& — !〜++ - sizeof 

二項演兑子&&と I I は同じ優先度を持つ. 
sizeof 演兗子は， fid 列のサイズを正しく評価できない. 

18.2 宜首 

宣言のための安全な構文は， 

data - aefinition : 
type-specifier declarator - list ; 

18.4 外部定義 

データ定義： 

type-speciner declarator - list ; 


18.5 プリプロセッサ 

次のプリプロセッサ命令が，サポートされる. 


# define identifer token-string 

# include M filename ” 
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# inclure く filename 〉 

# if expression 

# ifdef identifier 

# ifndef identifier 

# else 
#endif 

# under identifier 


# define は，ソース•ファイルの f こにでも現われうる.ファイルの最後まで， 
あるいはその識別子が再び# define されるか. undef されるかするまで，その有 
効範關は広がる. 


#il く expr > 


の命令は，サポートされる.しかし，正しい式エレメントは定数（記号定数を 
含む）と小さなセットになった演算子に限られる. # if 命令はユーザーが，注釈 
付きの，また注釈なしの# difine 命令を持つプレイゲームそして# ifdef /# ifn ¬ 
def もしく はその一方を使用することに賴らずに，システム従诚の条件付き式 
を# くことを認める.完全な構文については，上の セクション 12.3をみなさい. 

# include 命令は，条件付きコンパイルの内側に現われてはならない.これは， 
# include 命令は，入カファイルがディスクから読まれるときに，コンパイラに 
よって，オン•ザ•フライをすべて処理されるかたちで，条件付きコンパイル 
の処理は，全ファイルが読み込まれてしまった後になるまで起こらないからで 
ある.このように，たとえ# include 命令が偽りの条件付きコンパイルの中で鬨 
かれるとしても，# include 命令はいつもコンパイラに指定されたファイルを読 
み取らせようとする.これは，設計の欠陥のように思われるかもしなないが， 
すべての条件付き命令を処理し，標準 8" 単密度 CP / M ディスクから，適度な 
スピードでソース.ファイルを読み込む方法は他にない. 

条件付きコンパイルを使用するとき，各々の# else 命令は，符号する # endif 
命令によってつづけられなければならないことに注意しなさい. 
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ファイル包含は，どんな深さ 20 >にも入れ子にするかもしれない. 

しかし，一 P の CC オプションと， CC と CC 2 のためのエラー•レポートの両 
方は，ファイル包含がシングルレベルに限られると，処理するのが簡単になる. 


20) だが，互いの包含的 ファイルは， きっと オーバーフローを 引き起こす . 
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多方面にわたる注意窨 


一 演兑子=は，割当のためだけに使用される.関係演算子"それと同じ” 
は，==演算子によって代表される.混同しないように注意すること.まち 
がったものを使用しても， コンパイ ラに診断メ ッセージを 生成させない こと 
になる.というのは，出てきた式は，それらがたとえ望ましい効果をもっ 
ていなくても構文上正しいからである. 

ー キーワード begin と end は，左右のカーリー•ブレイス（{と})にとっ 
てかえられる.端末機にカーリー • ブレイス記号を持たないユーザーも， 
コンパイラを使用できるようにこの特色が与えられている.審美的にいっ 
ても，力ーリー•ブレイスは begin と end よりもはるかに読みやすいリス 
ティングをつくるし，可能ならいつでも使用されるべきである. 

— コンパイラ 操作中の エラー 回復は，ある場合，特に聡明ではない. CC か 
CC 2 のいずれかが 閬じラインか あるいは，いく つかのセット になった行の 
まわりのひとかたまりの エラーメッセージを 出すような場合，最初の エラ 
一 •メ ッセージ だけが信じられるべきである.その エラーが 修正された後 
では，残りは消えてしまうだろう. 

ー エラー •レポートの中で CC 2 によって与えられたライ ン •ナ ンバーは， 
必ずしも正確だと保証されていない. CC はたまに，コードの配列直しをす 
る.たとえば， for 命令文の増加部分は，命令文の部分を越えて，物理的に 
ムーブ•ダウンされる.このように， CC が検知するように備えられていな 
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い.増加部分の中にェラーがあれば， CC 2 がそれを検知し，まちがってラ 
イン•ナンバーをレポートする. for 命令文の増加部分を混乱させないよう 
にしなさい. 

あるタイプのエラーは，ソースの残りを走査せずに，実行をやめ，すぐ 
に 0 S へ戻すことがある.これが起こるのは，たとえばペアレンセスの組み 
合わせのまちがいや，セミコロンがなかったりして，それが回復できない 
ポイントで，コンパイラが混乱するようなときである.正しい句読点があ 
るべき場所について見当をつけるかわりに，それはエラーをすばやく定め， 
もう一度，トライするために打ち切る. 

C の main 関数へパスされた argc 値は，規則によっていつも正で，引数 
の数+1に等しい.コマンド行における引数は，いつも文字列で，値では 
ない.数字コマンド•ラインのパラメタを，変数へ割り当てるのに適切な値 
に変換するために， atoi 関数のようなものが使用される. 

" bdos ” ライブラリ関数に関する問題は，それがシステム従城であるの 
で，むしろ扱いにくくさせてきた.普通のデジタル•リサーチ CP / M シス 
テムのもとで正しく走っているプログラムは， bdos 関数が使用される場合 
には， MP / M あるいは SDOS (他にどれほど多くのシステムがあるか知ら 
ないが）のもとでは走らないかもしれない.この問題の典型的な徴候は， 
文字出力において，キーボード上の文字は出力の各文字が現われるように 
するために，一度打たれる必要があるということである.その問題を理解 
するために，まずはじめに我々は， CPU レジスターが， 0 S の BDOS コー 
ルの後にどのようにセットされるのかを正確に理解しなければならない. 
普通の CP / M の動作（ライブラリ関数 bdos がいつも取っている）は，リタ 
ーン値の低位バイトを含むためのレジスター A と L のためのものであり， 
リターン値（リターン値が，1バイトだけならそれは 0) の高位バイトを 
含むためのレジスター B と H のためのものである. CP / M インターフェイ 
ス•ガイドは，”すベての場合，リターンのときには A == L ， そして B == 
L である）と言っている.また，私が示したところでは， CP / M 1.4 あるい 
は他のシステムが B と A から H と L の中に値を置かなかった場合，その値 
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が HL (ここでリ ターン 値はいつも C ライブラリ関数によって配置されな 
ければならない）の中にあることを確かめるためには， bdos 関数に， レジ 
スター A を レジスター L に， レジスター B を レジスター H へコ ピーさせる • 
だが，すべてのシステムが実際にこの規則に従うわけではない. MP/M 
において， H と L はいつも正しい値を含んでいるが， B はそうではない. 
だから B が H へコピーされるとき，まちがった値が出る.ゆえに， CP / M と 
MP / M の両方のもとで， bdos を実行させる方法は， B と A を H と L へコピ 
一するのを中止することであり，値がそのシステムによって， HL の中にも 
正しく残されると仮定することである.これは V 1.45 のために行われたの 
で，少なくとも， CP / M と MP / M は気を付けている.が… 

SDOS のもとで（そして，たぶん他のシステムでは），レジスター A は 
時々意義のあるリターン値を含む単なるレジスターである.たとえば，フ 
アンクシヨン•コードのコール（コンソールステータスを調べる）からの 
リターンのときに， B , H ， L レジスタは，すべて不要部分を含んでいるのを 
みつけられる.だから，こういったときにコピーが行わなければ，リタ ー 
ン値は A から L へといかないし，結果も悪い.しかし， B が L へコピーさ 
れて， A と共に H へコピーされる場合，その結果はやはり悪い.というの 
は， B が不安部分を含んでいるからである.明らかに， SDOS のもとでフア 
ンクシヨン•コードを正しく作動させるための唯一の方法は， bdos 関数に， 
レジスタ A を L にコピーさせることであり，リターンする前に H レジスタ 
をゼロにしてしまうことである.しかし， H の中に値を戻す多くの他のシ 
ステム•コードはもはや作動しないだろう.そして，それが，問題なので 
ある.いつも，あるシステムを気に入るかもしれないが，すべてのシステ 
ムがいつも唯一の標準の bdos 関数であるというわけではない. 

bdos は， CP / M と MP / M と共に作動するので， V 1.5 のために bdos を 
残す方法はある（たとえば，レジスターの コピーが 全然行われなくて，… 
HL は正しい値を含んでいると仮定される）.もちろん，これは SDOS やた 
ぶん他のシステムでのすべての場合に作動しない.このような場合 ， BDOS 
コールを なすために， call と calla のいずれかを使用する必要がある.ある 
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いは，ユーザーのシステムのために正しいレジスターの操作順を実行する 
ために bdos 関数 （ CASM を使用して）のアセンブリ•コード化された自 
分自身のバージョンをつくる必要がある.すべての可能なリターン値のレ 
ジスター構成をカバーするために，このような関数が一つ以上必要である 
ことに注意しなさい. 

よ く 設計され た C プログラムというものは， ューザーにコマンド 行構文 
を表示し，打ち切ることによって コマンド 行エラーをいつも診断するべき 
である.これは，一般に" Usage ” メッセージ として知られる：これは， 
何が コマンド 行で予想されるかを ューザーに 思いつかせるし，しばしば， 
何回もそのプログラムを使用する人を助ける. コマンド 行 •オプションが 
あれば，それらは，スクェア •ブラケット，[，で 示されるべきである•良 
い見本として， サンプルのコマンド 行と共にすベての オプションの 詳細は 
説明を含むものである. 

外部初期化は，コンパイラによってサポートされないけれど，便利な関 
数のいくつかは，単純な整数と文字の配列の初期化を認めるために与えら 
れている.整数値へ連続する数のかたまりをセットするために，関数 initw 
を使用する.文字列のためでなく，文字のためには （ 0 —255の問の単ーバ 
イトの整数)， initb を使用しなさい. 

たとえば， 

int foobar [10]= {3, 2, — 2, — 5, 3, 6, 9, 一23,—14, 0} ; 

という UNIX C の構文をシミュレートするために，まず， 
int foobar [10] ; 

を行うことによって,普通 foobar を宣言できる.それから，命令文， 

initw ( foobar , "3, 0，—2，—5, 3, 6, 9, —23, —14, 0”)； 

を main 関数の中にインサートする. 

次の要項は，最適効率のために努めるとき，心にとめておくべきであふ 
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1. コメントは，そのファイルがディスクから読まれるときに，動的にソー 
スファイルから取り外されるので，プログラムを十分に文書化しないこと 
は許されるものではない（それは怠惰である）. 

2. switch 文は， switch 内の変数（たとえば” switch ( xx ) …”の中の xx ) が 
char として宣言されるとき，最も効率的である.整数値は，しばしば，フ 
ァイル I / O を含むァプリケーシヨンを処理しているテキストの中に，文字 
値をかかえ込むのに使用される.大きな switch の前に，そういった値を文 
字変数へ割り当てると，メモリーをセーブすることができ，実行をスピー 
ド • ァップする. 

3. switch 文の中の case は，その出現する順にテストされる.だから敁も共 
通とするケース（あるいは，最も速い応答時間を必要とするもの）は，先 
に税われるべきである. 

4. 最高スピードでコンパイルを実行するために， CC コンパイラに 一 〇 
と 一 e xxxx オプションを与えるべきである•コ ー ドの長さを最も短くす 
るためには，一 e xxxx オプシヨンだけを CC に指定すべきである. 

5. C の中の論理式は，値が実際に必要とされているときはいつでも，数値 
0 (偽の場合)，1(具の場合）へ評価する.しかし，処理の流れのテスト 
で使用されるときは，どんな値にも全く評価しない.これが意味している 
のは， ユーザーは 多くの状況で，論理式の数値の結果を利用できるという 
ことである.次のコードの一部を考えてみなさい.その目的は ， a く b の場 
合は1に， a > = b : の場合は0に，変数 x をセットすることである • 

if (a く b)x = l ; 
else x = 0; 


[ nj じ操作は 


x = (a < b ); 


と書かれうる. 
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これは，サブ式 ” （a く b )” が自動的に必要な値に評価をする方法を利用 
し，2つの別々の割り当て式，それらの連想コントロール構造，すべての 
伴っている相当なオーバーヘッドといったものの使用をさける. 

6. 簡略化に関連する機会は，変数がゼロと同等か不等かをテストされるの 
が必要なときはいつでも生じる.どんな式でも，論理的には"真”とみなさ 
れるので，その式がゼロ以外の値に対して評価する場合，” a ! = 0” のような 
式の” ！ = 〇” の部分は,特に余分なものである. 

if ( a ! = 0 )printf (” A is non — zero ”）； 

あるいは ， if ( a = =0) printf (A is zero ”）； 

のような命令文は， 

if ( a ) printf ( ” A is non — zero ); 
if (! a ) printf (” A is zero ”）; 

と同様に書かれる. 

もちろん，そのような簡略化は，与えられた状況にいつも適切とは限ら 
ない.問題の変数が，向かうカウンタとして使用され，多くの異なった値 
を引き受けることを期待されている場合，" a ! = 0” といった方が，そのプロ 
グラムの論理に対してよりタリアであるかもしれない.変数が ブール •フ 
ラッグとして使用されたり，ゼロの値がある意味で特殊に考えられたりす 
る場合，短目のフォームの方がクリアであるし，事実，より短目のオブジ 
ェクトコ ー ドへ 導く場合もある. 



付録 B 


エラーメッセージの 説明 


B .1 CC エラー•メッセージ 

この文身の中では， directory という項目は，任意の CP / M の論理ドライブと 
ユーザー領域の組みわせを表わすのに使用される. 

ファイル I / O エラー 

close error ディスク • ドライブ • ドアは開いているか？もしそうでなけ 
れば，おかしなハードウエアの問題をかかえていることになる. 


Error on file output".disk full ? 


もしもそうでなければ，ハードウェアをチェックしなさい • 

Can’t find CC 2, COM;writing CCI file to disk 

2 つのディレクトリがあり，そこで CC が CC 2. COM をさがし出そうとす 
る.その2つのうちの1つは，常に現在のディレクトリであり，もう1つは一 a 
オプションが CC で使用されるか否かにかかっている.もしそうならば，オプ 
ションで指定されたディレクトリが検索される.さもなければ，デフォルトの 
ディレクトリ（第1章の設定セクションで定義されたように）が検索される. 
CC 2. COM が検索される2つのディレクトリの中で見つからない場合，このメ 
ッセージがプリントされる. 
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DISK read error 


新しい フロッピーをフオーマッ トするときでは? 
し annot open : < filename ) 


指定され たファイルが みつからない. ユーザーがアングルブラケットでの 
まれた# include ファイ ルを求めて，特殊な ディレクトリ を検索するために CC 
を設定したのなら， ユーザー • ナンバー/ディスク 指示子はこの エラー•メッ 
セージの 中で ファイル ネームを先導して プリント される • CC が 設定されなか 
ったのなら， ディスク 指示子だけが現われる • ユーザー.ナンバーの 接頭辞は， 
CC のコマン ド •ライン 上では許されないので， トップ • レベルのソース•ファ 
イ ルは，異なる論理 ドライ ブ上にあるけれども， CC が 呼び出されるときに現在 
のユーザー 領域の中に常になければならない. 

オーバーフローの状態 

sorry;out of memory 

ソース•ファイルが長すぎて，メモリーに入りきらない.メモリーをもっと大 
きくするか，もし W ■能な らそのソース•ファイルをもっと小さく くだくかする 

Out of symbol table space;specify more … 

CC でシンボル • テーブル • スペースを予約するために，一 r オプション 
を使用しなさい.あるいは，そのソースのファイルをもっと小さいものにくだ 
きなさい. 


Too many Junctions (63 max) 


単一の BDS C の ソース•ファイルに63 以上の関数の定義を含んで いる. 
63 以上の_数を持つ ているプログラムを， 別々の ソース.ファイルへ 分割され 
なければならない. 
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String too long (or missing quote ) 

たいていこのエラーは，文字列のまわりに二重引用符をつけるのを忘れ 
ているときに起こる.文字列が正しく区切られているようであれば，文字列の 
範 t 相内にエスケープされていない（バックスラッシュでそれを先行している） 
二重リ I 用符記号を含んでしまっていないかどうかをチヱックしなさい. 


Too many cases (200 max per switch ) 


Case 文が 200 をこえている. 

# include files nested too deep 
これは，再起包含をしようとする場合に起こったりする. 


String overflowjcall BDS 


これは，# define 命令の中でとても良い識別子をあまり多く持ちすぎた 
ために起こる.プリプロセッサの文字列 テーブルの オーバーフロー である.こ 
れはとてつもな〈大きなプログラムのときにのみ起こってしかるべきである. 

より大きな文字列のスペースの割り当てを持つコンパイラの特殊な パ、ー ジョン 
は，ある稀:の BDS C パッケージ購入証明と共に， BD ソフトウェアへ SASD 
iself-addressed stamped disk , マスターデイスケット）を送れば得じれみ 


ブリプロセッサ エラー 


Warning:Ignoring unkhown preprocessor directive 


サポートされていないプリプロセッサディレクティブに出〈わすと，こ 
の释告がプリントされる.現在のところ，これが唯一の非致命的な診断メッセ 
ージである. 

Eof round whem expecting u endif 
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条件付きコンパイルが不当に区切られている. 

Not in a conditiondl block 

# if # ifdef がないのに，# endif がある. 

Conditional expr bad or beyond implemented subset 

CC は， # if プリプロセッサの中で，演算子のサブセットしか使用できない. 
if 式の構文の要約に関しては，第4章をみなさい. 

Bad parameter list element 

悪い識別子が，関数定義のパラメタ • リストの中に現われた. 

Missing parameter list 

パラメタ化された# define からの識別子がそのパラメタなしで現われる. 
Parameter mismatch 

パラメタ化された# define からの識別子が，その定義の中のものとはちがっ 
たパラメタの数で使用されている. 

Missing legal identirier 

識別子が式の中で期待されているのに何も現われない. 

構文エラー 

注：終結していないコメントは，コンパイラからあらゆるかわったエ 
ラーメ ッ セージを引き出すことができる.次のメ ッ セージのうちの 
一つが現われて，その原因がわからないのなら，一 P オプシヨンを 
CC に与えてみなさい.そして，そのコードがプリント•アウトの中での 
あるポイントで”カット•オフ’’し，そうであれば，チェックしなさい.も 
しそうならば，それはたぶん，開じられていないコメントの位諝である. 
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というのは，次のテキスト全部は，コメントの部分として解釈され，プリ 
ント•アウトの前にソース.ファイルから除外される. 

Encountered lOF unexpectedlv(check curlv-brace balance ) 


m じていないコメント，そして閉じていないカーリー•ブレイスをチェック 
しなさい.ユーザー•グループのプログラム LCHECK.C は，レベルを入れ子に 
するカーリー•ブレイスをチェックするのに使用される. 


Unmatched rignt brance 

左のブレイスがないか，あるいは関数のない右プレイスがあるかのいずれかである. 


Illegal external statement 


これはたいてい，関数の中に右ブレイスが多すぎたために起こり，コンパイ 
ラに早まつた関数定義の末尾の検知をさせる. 


Function dennition not external 


これは，何か関数定義のようにみえるものに，別の起動可能な関数定義の範 
Lttl 内で出くわしたときに起こる.たぶん，それは関数 コールの 後に セミコロン 
がないだけか，あるいは類似した型がある場合である. 

Missing semicolon 

この エラーが 意味しているのは，たいていそれが何かを言うということであ 
る.しかし，セミコロンを忘れていると，あまり意味のない エラー •メッセ ー 
ジを引き起こす場合もある. 

expecting ( 

大体 while if switch というキーワードの後に出くわ寸 


Unmatched left parenthesis 
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これは，大抵検知されるエラーのうちの別なタイプであるが，ある場合他の 
あまり意味のないメッセージを生成するかもしれない. 

I’m tolally confused Check your control structure ! 

これは， f 用係のない文字，あるいは誤ったカーリー•ブレイスのネステイン 
グによって起こる. 

Illegal { encountered externally 
不適当なカーリー•ブレイスによって起こる • 

Mismatched control structure 

テーマを入れ子にしている不等なカーリー • ブレイスにおける別なバ 、リエ ー シヨン. 


Expecting while 

は， do … while 文にその while が欠けている. 


Illegal break or continue 

break 文は， Switch 文とループの内側で許されるだけである. continue 命 
令文は，ループの内側でのみ許される. 


Bad for syntax 

自明のことであるが，セミコロンの正しい数 (2) とその配置をチェックしなさい. 
Expecting {in switch statement 

switch 文の式の部分は，カーリー•ブレイスの中の複合命令文によって読ま 
れなければならない. 


Bad case construct 


各 case の定数は，絶対定数か単純定数式（文字定数はもちろん受け入れられ 
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る）のいずれかでなければならない. 


Illegal statement 

この エラーは，たとえば case や default 文が， switch コンストラクトの外側 
にみつかるときに起こる. 


Syntax error 


このエラーを 引き起す のは， 大体不明脫な何かである.たとえば，文字列の 
前に左の二重:引用符がない場合，ファイルの中の関係のない文字もこれをリ I き 
起こす. 


Bad constant 


switch 式や case 定数のために使される fift のように，定数式でなけれはな 
らない式がいくつかある. 


Bad octal digit 

ゼロで始まる数字の8進定数が， 8.9 という数字を含んでいると，このエラー 
が起こる. 


Bad decimal digit 


10進定数が，悪い文字を含んでいたり， ユーザーが 順序 Ox でもって，16進定 
数を先行するのを忘れていると，これが起こる. 

Curly-braces mismatched somewhere in this runcuon 

これはむしろ，コンパイラにとって有用な特徴である • ソース•テキストが 
左のカーリー.ブレイスを多く持ちすぎていると，このエラーは最初に起こっ 
たミスマッチを検知した関数の始まりに対してさし示す • 
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宜曾 エラー 


Undeclared identifier : く name > 

-れは申-に寅3されなかっただけの本当の識別子であるかもしれ ない. ある い 
は，疏^ J 子のスペルのまちがいかもしれ ない 

Bad declaration syntax 

たいてい コンパイラは， 型指定子 （ cher ， int のような）をみ つける と， すぐ 
にそれは， データ 宣言を処理していると思う.この エラーは，そのキーワード 
を含む命令文の残りの部分が宣言と似てない場合に起こる. 

Need explicit dimension size 

配列が関数に対してフオーマル •パラメ タであるときにのみ，配列宣言の中 

で次元サイズを省くのが許される.そういった配列が二次元なら，その第一次 
元だけが省かれる. 

too many dimensions 

BDS C は，一つの配列変数につき，最高2までの次元を認めている. 


Bad dimension value 


配列宵バの中の次元は，変数としてあるいは定数式として与えられなければな 
らない. 

Redeclaration of : < name > 

単一変数のための複数の不一致な宣言を，実際に書き込むことは別にして， 
この エラーを リ|き起こすのは， ボディーの 直前にするかわりに関数の ボディー 
の内側で関数のパラメタを宣言するとこうなる.その関数の ボディーの 前に宣 
d されなければ，パラメタは自動的にタイプ i nt を与えられることに注意しな 
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さい. ゆえに，関数のボディーの中の局所変数として， フォーマル •パラメタ 
識別子のその後の宣言は再宣言を構成する • 

Expecting in struct or union del 

構造体または共有体で{がない. 

Illegal structure or union id 

構造体宣言の構造体タグの位設に現われる薇^子が，先の構造体タグとちが 
う何かとして宣言されたときに生じる. 


Attribute mismatch from previous declaration 


人きな诚性（タイプとオフセット）を与えている他の構造体の範 M 内で，再使 
H 1 される構造体宣言の中のエレメントは，各構造タイプの範囲内では W じであ 
る. f 薄造エレメント • ネームが異なる诚性を用いて再使用されるときに，この 
エラーが現われる. 


Declaration too complex 


あまりに多くのレベルの問接的手段があるときに，このエラーが起こる•あ 
るいはコンパイ ラがあまりに多くのかっこを操作するときに起こる. 

Missing from formal parameter list : く name 〉 

_ 数ボディーの前にパラメタの宣言が現われると，これが起こる.しかし， 
そういったパラメタは，関数名につづくパラメタ•リストの中に現われない. 


Bad parameter list syntax 

I 尚数定義のパラメタ.リストの中のコンマで区切られた識^子のリスト以外 
の何ものかがこのエラーを引き起こす. 
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いろいろな エラー 


く text〉:open error 

cc がまちがって形づくられた コマンド 行のオプションを検知する場合に， 
このメッセージと共に理解できなかったテキストをプリントする.正し いフォ 
ームを確認するために，第1章の中の コマンド • ライン.オプションの記述を 
チェック しなさい. 

compilation aborted by control-C 

コンメ、 0 イルの間に ユーザーが， コンソ ー ル上でコントロール ー C をタメザす 
る場合，このメッセージがプリントされ，コントロールはコマンド. レベルに 
戻される.コンソールポーリングは，第1章の設定セクションでのべられたよ 
うに， CC . COM の特殊な設定によって割り込み不可能になることに注意しな 
さい.これは，割り込みを受け付けるシステムのためにコンパイラの実行中に 
タイプ.アへッドを認める. 

Can’t have more than one default : 


1 つ以上の default があると，これがプリントされる：句は特別な switch 
コンストラクトのために出くわす. 


Illegal colon 


コロン（文字ストリングの中以外に）は，3進演算子の部分として認められ 
ているだけである • あるいは， case , default といったラベルの後につづく 

Undefined label used 


フベル•リフ アレンス （ goto 文の中でのみ認められている）は，現在の関数 
定義に対して局所 的な ラベルを 参照す る 
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Duplicate label 

特別な識別子は，一つの関数ごとに一つのラベルのために使用されるだけで 
ある. 

B .2 CC 2 エラー •メッ セージ 

CC 2 のプリントしたファイル I / O エラーのいくつかは同じであるか，または 
CC のためにあげられたメッセージと非常に類似している.だから，このセク 
シヨンでは繰り返して述べない. 

ファイル I / O 構文，オーバーフロー，その他のいろいろなエラー 

Can’t create CRL file 

出カドライブ上のデイレクトリがいっぱいになった？ 


CRjl Dir overflowrbreaK up source tile 

各 CRL ファイルに割り当てられたデイレクトリ • スペースは，512バイトあ 
るだけである.ネームの中に8•あるいはそれ以上の文字を含んでいるように定 
族された関数（各ネームの最初の8つの文字だけが実際にデイレクトリの中に 
記憶される）をあまり多く持ちすぎると，擎一のソース•ファイルのためにデ 
イレクトリ •スぺ ー スを才 ーバー •フロ ーすることがある.関数名を短かくす 
るか，一つのソース • ファイルごとの関数の数を滅らしなさい. 

Internal error : garbage in me or bug in し 

これが CC 2 の問に起こったなら，それはたぶんコンパイラ•バグである.援 
助の必要なときは， BD ソフトウェアに連絡して下さい. 

Illegal statement 


大体，ワイヤされた何かに出会った. 
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Missing { in function def 

このエラーを引き起こすものは，どれも本当に関数定義のスタートではない. 
しかし，わけがあって前の（あるいは現在の）関数が終結してしまったと，コ 
ンパイラが考えて，別のものが始まる.プログラムの中に多〈右カーリー•ブ 
レイスがありすぎないか，どうかをチェックしなさい. 

Missing semicolon 

式，命令文の後にセミコロンがないと，たいていは検知され正しく診断され 
る. 

sorry , out oi memory , Break it up ! 

ファイルが長すぎる.たいていの場合 CC を通るものは， CC 2 も通るが，例 
外もある. 


The runction < foo > is too complex;break it up a bit 


あまりに大きな関数を操作することのできないある内部のテーブルがある. 
いろんなテーブルやリストのために，どれほどのスペースを予約するのかを， 
コンパイラに教えて いる • ひとかたまりの混乱しているパラメタをユーザー 
がセットするように要求するよりも，むしろほとんどのテーブル•サイズ定数 
をセットし公正に重い関数を認めるように決めた.しかし，ある程度までであ 
る.正しく構成された C プログラムは，このメッセージを出すべきでない. 

sub-expression too deeply nested 

この エラーのほ とんどの原因は，永遠につづく多重割り当ての命令文である. 
解決法は単にそのラインを小さめのものに分けるとよい. 


Compilation aborted by control-C 


CC の適切な設定バイトが， ユーザー によってゼロにカスタマイズされなけ 
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れば（チャプター1の設定のセクシヨンをみなさい），システムコンソールでコ 
ンロールー C をタイプすると，コンパイル作業は終結し，このメッセージをプ 
リントし，すぐにコマンド•レベルに戻る. 

式における エラー 


Lvalue required 

オブジェクトは，アドレスを用いるか，割り当て演算子の左で正しくなけれ 
ばならないことを要求される. 

Lvalue needed with + + or - operator 

电純変数だけが，自動増加，あるいは自勋滅少されうる. 

Bad lett operand in assignment expression 

割り当て演兑の左にある式が，それに割り当てられた値を持つことができな 
いと，この エラーが 起こる•たとえば，文字列よりは Lvalue ではないが，正し 
い Lvalue を生み出すために添え書きされる. 


Mismatched perenthesis 


左のペア レン セスにつづく式は，マッチし t いる右のスクェア•ブラケット 
の後すぐに続けられない. 

Bad expression 

これは，式（あるいは式になると想定されるもの）が，コンパイラにとつて 
意味をなさないときにプリントされる一般的なェラーメッセージである.これ 
は必ずしもェラーが明白であることを意味しない.しかし，たいていはそうで 
ぁる. 

Bad function name 
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これは，コンパイラが左のペアレンセスの直前の識^子を見たときに， その 
識別丫•が先に関数名以外の何かとして宣言されてしまっているときにプリント 
される. 

Bad arg to unary operator 

単項演兗子のオペランドは，その演算子にとって適切なタイプのうちに入ら 
ない. 

expecting : 

?:式を書こうとしたのか，またはコロンを含むのを忘れたかである. 

Bad subscript 

ポインタにとって正しいタイプの配列添え字は，算術演算か？たとえば， 
配列式の中での添え字はポインタであり得ない. 

Bad array base 

添え字のできないことを添え書きしようとしていることになる.一般的な原 
W : main 関数の中の argv を正しく宣言していないのに，添え書きしょうとし 
ていないか. 

Bad structure or union specification 

• (ピリオド）演兑子の左に対する式は正しい構造体，あるいは共有体のベー 
スではない. 

Bad type in binary operation 

あるタイプの変数は，二進の演算子の中ではいっしょに現われない.たとえ 
ば，2つのポインタを加えることはできない（それらを滅兗 すると， 目的の値 
の始まりがさし示すサイズによって，概算された結果を生む）.あるいは，単一 
変数以外の目的の値では，ほとんどのビット.ワイズのそして不明瞭な演算な 
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Bad structure or union member 

. (ピリオド〉，または—の演兑子の右に対する式は，有効な構造体でも共有体 

エレメントでもない. 

Bad use or member name 

構造体や共有体のメンバーとして宣言された識別子は，構造体や共有体の操 
作の外側で使川されえない. 

Illegal indirection 

H 的はポインタではないのに，それがポインタであるかのようにいくつかの 
H 的で操作するように試みがなされている. 


Encountered JiOP unexpectedly 


これは，悪い構文の エラー か，ファイル拟失のサインのいずれかである. コ 
ンパイラの現在の バージョンは， たいていこの種の エラーに 関してもっと具体 
的であるけれども，うまくマッチしていないカーリー•ブレイスも原因になる 
かもしれない. 


Bad argument List 


閲数 コールの ためのパラメタ.リストの中で，不当なものがみつけられた. 
たとえば，式の中で正しくないセミコロン，あるいは他のキーワードなど. 

Missing misplaced ( 

while キーワードなどの後の （） 内の式がない.また，左かっこがみつから 
なかった. 


Missing or misplaced ) 
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左のペアレンセスで始まる式は，閉じの右かっこによってその後を続けられ 
なかった.これは，式のまん中での間係のない文字のせいかもしれない. 

B .3 CLINK エラーメ ッ セージ 

注： CLINK によってプリントすると思われるファイル I /〇のエラ 
一の多くは，説明の必要はないが，注釈の必要なものだけをここにあ 
げておく. 


No user area prefix allowed on main filename 

ユーザー領域の接頭語は， CLINK コマンド行における第 1 番目のものを除 
いて，すべてのファイルネーム上で認められない. 


Dir full 

新しい出カフアイルをつくるためのデイレクトリ • スペースがない. 


Error writing : く filename 〉 

たぶん，ディスク上のデータ•スペースがなくなった. 

し an’t close : < nlename > 

ハードウ エアの エラー か？ 

No main function in く nlename 〉 

CLINK コマンドライン上で指名された最初の CRL ファイルは，ユーザー 
がリンクしようとしているプログラムのために， main 関数を含んでなければ 
ならない. L 2 リンカー（ユーザーズ•グループから手に入る）には，この規制 
がないことに注意しなさい. 


Missing function ( s ) :〈関数名〉 



f^B エラーメッセージの说叫 


131 


表示された関数は，コマンド行でリストされたファイルのうち，あるいは標- 
準ライ ブラリ.ファイルの中でみつからなかった.ファイルをロードするので 
はなくて，走査するために一 f オプションを使用した場合，衍名された関数の 
いくつかは表示されうるが，ロードされない.前の I 肖数が，それらを参照しな 
かったからである.この場合，落としていた関数を含んでいたファイルを再走 
査するだけでよい. 

Warning ! Externals extend into the BDOb ! 

外部データ領域の終りアドレスが， BDOS のベースより大きいときに，これ 
がプリントされる.そのコードが，別の環境で実行される予定なら，このメッ 
セージは無祝される.しかし，リンカーがこのメッセージをひき起こしたよう 
なシステムで，そのプログラムを実行しようとしてはならない. 


Warning ! Externals overlap code ! 


外部データ領域の開始アドレスが，プログラムの最後のコード•アドレスよ 
り小さいか，あるいは等しいとき，これがプリントされる.たいていこれが意 
味するのは，外部領域が 一 e オプションでもって，あまりに低く置かれたとい 
うことである.そのコードが外部領域の上に常駐するカスタマイズされた環境 
のためのものなら，そのメッセージを無視しなさい. 

Out oi memory 

リンクするにはメモリーが不十分である . L 2 リンカーを使用してみなさい. 
それは， CLINK よりも最高8 K 大きくプログラムをリンクできる. 


Bad symbols 

一 y オプションの使用によって，読み込まれたシンボルファイルがうまく書 
式化されていないエントリーを含んでいる. 


Ref table overflow 
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前方参照テーブルのスペースがなくなった.もっとスペースを予約するため 
に， 一 r オプションを使用しなさい.使い方は” -r xxxx ’’である.ここで xxxx 
は16進で与えられる. 600はデフオルトのものである.エラーがなくなるまで, 
800や A 00 などを試してみなさい. 

SYM file symbol already defined : く svmbol 〉 


一 y オプシヨンの使用によつて読み込まれるシンボルは，すでにロードされ 
定義された_数と同じである.元の値は，キープされる.というのは，その関 
数はすでにロードされているし，定義されている.もしくはその一方であるか 
らで新しいものは捨てられる. 

Ignoring duplicate functon : く name 〉 


ロー ドされている CRL フアイルの中の関数は，前のフアイルからすでに口 
ー ドされた I 対数と同じ名前を持っている.オリジナルはオープンされ，新しい 
バージョンは無視される. 

さ orrv : 255 iuncs maximum 


CLINK は，単一のリンクにおいて敁高255までの関数を操作できるだけであ 
る.もしもっと多くの数の関数をリンクする必要があるなら ， BDS C ユーザー 
ズ • グループから L 2 リン カーを _入しなさい. 



付録 c 


初心者の c プログラマーが起こしやすいまちがい 


C 言語には，いろんな側面があり，はじめて取り組むものは多くの問題をひ 
き起こしがちである.このセクションで私は，困惑したユーザーが電話や手紙 
でひっきりなし に 持ち込む複雑な問題， C の”特徴” について まとめてみよう 
と思う. 

c . 1 " =，，卜 •«==»» 

演 P ■•子=は，割り当てのためにだけ使用され，演算子==は，"等しい，，に関 
係のある状態をテストするのに使用される. 2つの演算子は，それらを表現す 
るために使用される文字を除いて，共通するものは何も持っていないが，混乱 
したときにデバック時間を無駄にすることもある. 

C で共通しているコンストラクトは，より大きな式の中で記憶された割り当 
て操作をすることであり，たぶん条件語句を含んでいる.これは， 

if ((c = getchar ( ))= = , \ n , ) 

print f (” You typed a newline !\ n ”）； 

のような命令文へと導くことができる.ここで， C の初心者は=の操作をそれ 
が実際にある別り当て式のかわりに，条件付きのテキストとして解釈するかも 
しれない1 
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次のコード分割を考えてみなさい. 

if (!(c = getnext ( ))) { 
printf ( " All done \ n ，， ）； 
break ; 

} 

この命令文の中の if 式は， getnext 関数から変数 c へリターン値を割り当て， 
そのリターン値がゼロかどうかを調べる.もしゼロなら，” All done ” をプリ 
ントし， break する.もちろん，疲れたプログラマーがこれを非常にはやくみた 
なら，それは c が getnext のリターン値と 比較 されているかのように思われる 
かもしれない. 

C .2 配列の添え害き 

C では，長さ n の配列は，0から n — 1までの数字の ついた エレメントを持 
つ ている.ユーザーが長さ n の配列を宣言し，値 n の添え字でエレメントを参 
照しようとするなら，ユーザーはその配列の終りを過ぎてデータを参照してい 
ることになる.これが一番ひんぱんに起こるのは，ユーザーが BASIC 言語の面 
からものを考えているときである. BASIC では，長さ x の配列はエレメント • 
ナンバー0とエレメント•ナンバー X の阀方を持つ（最近の BASIC では option 
base 文によつて低数を変えられるが…） . C において一番一般的な for - ループの 
コントラクトは次の 

for (i = 0; i く n ; i + +) 


のように 0 から n — 1 までの数字の ついた n 項目を通して く り返す.そして， 
そういったループは，配列を通してくり返すには理想的である.もし， n 項目 
のために，本当に1から n まで数字の ついた 配列を持つ必要があるなら，要求 
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されているのよりも一つ多い項目を持つように配列を宣言し，未使用の〇番目 
の エレメント を残さなければならない 


C .3 いかにしてポインタを使用せずにおくか 

ポインタ変数が外部か，関数内のいずれかの，プログラムの中で宣言される 
とき，それは自動的に値を与えられない•ポインタは16ビットの変数であって， 
データの他の部分のアドレスを保つために使用される（そしてさし示すため）. 
そして，変数と同じく，使用の前に初期化されなければならない.一番よくみ 
うけられるミスは，初期化されていないポインタを通して，問接的に値を削り 
当てることである.たとえば，宣言 

char * foo ; 

は， foo が初期化される前に 
* foo = ’ a ’ ； 

のような命令文が後につづいたとき，予測しなかったことが起こり始める•上 
記の剖り当て命令文のいっていることは，"変数 foo の値によって指定されて 
いるアドレスを持つ ロケーションに 文字《 a ，を; g きなさい，，ということで あ 
る. foo が何ものに対しても初期化されていなかったら，文字， a ， は，メモリ 
一の中のランダムな ロケーションに 記憶される • ここで，正しい手順をいうと， 
バッファ領域を宣言し，その領域のアドレスに foo を刻り当て， foo を通して間 
接的にデータ割り当てを始める • たとえば，次の順で文字 f a ，を buffer [0] 
の ロケーショ ンに廣く. 

char buffer [50] ，* foo ； 
roo = & buffer ; 


* foo = f a '; 
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C .4 閧数はポインタをその自動データに戻すべきでない 

関数が呼ばれたプログラムに戻り次第，その関数に対して局所的だった記憶 
(たとえば，すべての宣言された局所変数が記憶された場所）は，割り当てを 
解除され，次に呼ばれる関数による使用のために準備される.一般的なミスは 
ある閲数（それを foo と呼ぶ）に，局所的なバッファの中である文字列を作ら 
せ，その文字列のポインタを戻させることである • foo から戻ってすぐに，その 
文字列はもとのままである.しかし，もっと後のプログラムの過程では（その 
文字列が常駐しているスペースは，他の関数の局所データエリアのために割り 
当てられるように），その文字列は不要部分にかわる.こういった問題の解決法 
は2つある. 

a ) f 00 に，ストリングの結果をどこにおくかを教えるパラメタを取らせな 
さい（この場合，呼び出すものは foo のためにバッファを備える）.あるい 
は， 

b ) 外部領域に文字列の格納場所をつくる. 

各方法は，その利点がある.各コールで自分の格納領域をパスすると，戻さ 
れた文字列が異なる領域のメモリーで別々にセーブされるようになる.一方， 
外部格納領域は，1つ少ないパラメタがパスされるように要求することによっ 
てコールする順を短かくする.しかし，何を行なおうと，その関数が戻された 
後でも有効のままでいるために，コールされた関数によって，局所的に割り当 
てられたデータを期待してはいけない!！ 

C .5 フ ォー マル • パラメタのきまり 

そもそも" フォーマル •ハ。 ラメタ ，，と は何か？ フォーマル •パラメタは関数 
が コールされ るときは，いつでもパスすると思われている引数の1つである. 
すべての フォーマル •ハ。 ラメタは関数名のすぐ後に続く （） で M まれたリスト 
の中で指定される.関数のボディーの始まりを表わしている一つめの{の前に， 
そして （ > で W まれたリストのす ぐ 後に関数の フォーマル ゾ 、。ラ メタの宣言が 
なされなければならない. 

明白に宣言されていないパラメタは，単に int の値とみなされる • フォーマ 
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ル•パラメタが偶然，実際の関数のボディー （{ } の内側）で宣言される場合， 
コンパイラは，”再宣言”エラーと診断するだろう.というのは， フォーマル. 
パラメタのための宣言とみてもいないのに， フォーマル • パラメタの宣言がパ 
スされ，コンパイルがその関数ボディーを処理し始めると，その フォーマル • 
パラメタは int として fJ 動的に宣言されてしまうからである. 

閲数の呼び出しがおこるときはいつでも，フォーマル.パラメタの値のコピ 
一がその関数へパスされる•そういった値のすべては ， BDS C バージヨン1に 
問する場合，長さ16ビットである.これが意味しているのは，本来16ビットの 
人きさをもたない構造体，配列，データタイプは間数へ直接パスされえない. 
そういったデータ•タイプに対してポインタであれば可能である.さて，配列 
名が関数へパスされるとき，何が起こるであろうか？ ftil 列へボインタをハ。ス 
するにあたって，混乱するかもしれないが，特別なそして不思議なメカニズム 
がある.それは，ポインタが実際にパスされている宣言構文からいって直観的 
に明内でない.たとえば，次の関数を考えてみなさい. 

int arraysum ( array ) 
int array [3]; 

{ 

retern array [0 ]+ array [1]+ array [2] 


arraysum が， 3 エレメントの fid 列をフォーマル •ハ。 ラメタとしてとっている 
ようにみえるかもしれないが，実際はその配列に対するポインタが ハ。ス される. 
その寅言は，全配列がパスされているかのようにみえる.しかし，配列の中で 
エレメントをチェンジする場合，ここでは， コールし ているプログラムから受 
け取ったエレメントをチェンジしている.配列は一つだけ存在している. 

フォーマル 配列パラメタに関して，もう一つひっかかりやすいポイントは， 
実際に配列名をコールされた関数の中での単ーボインタ変数として取り扱うこ 
とができる.ということである（たとえば，別の配列のアドレスをそれに割り 
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当てると，それは他の配列の ベースに なる）.しかし，そういったものは，その 
fld 列が実際の（非フォーマル•パラメタの）配列であるときには作動しない（事 
実，予想しない結果になる）.カーニンハン&リッチーの本は，ポインタと配列 
の”双対関係”に関する完全なチャプターをし含んでいる.このメカニズムは 
C の最もパワフルで，最も混乱しやすいものである. 

C .6 関数コールは （） を持つ 

関数名は，引数のリストなしで使用される場合，出てきた式は指名された関 
数のアドレスとして評価される.そのリストが空であっても，その名前が （） 
で M まれたパラメタのリストを後につづけられなければ，その関数に対するコ 
ールはなされない.たとえば，次の式， 

i = endext (); 

は，外部データ領域の終りのアドレスを変数 i : に割り当てる. 

一方，次の式 

関数 i = endext ; 

は， endext のアドレスを変数 i に割り当てる.だが， endext が先に宣言されて 
いる場合だけである. 

endext が先に宣言されていなければ， コンパイ ラは endext を”宣言されて 
いない変数’’として診断する.一つめの方の式では， endext は int を戻す関数 
として暗黙のうちに（文脈の中で）宣言される. 
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c プログラムにおけるダイナミックオーバーレイ 


exec あるいは execl (は， 事実 動作するが， 真の区分 化ツールよりももっと 
"チエイン”操作に似ている）に頼らずに， C プログラムが物理メモリーよりも 
M くいられるようにするために， CLINK プログラムはプログラム 区分 化を 可 
能にするためにくふうされている.一般的な考えは， C のランタイム•ハ。ッケ 
ージ， " main ” 関数，あるいは一つ以上のオーバーレイ•セグメントが必要と 
するかもしれない他の関数を含むメモリー （TPA の ベースで）で，ルート•セ 
グメントの 一つの コピーを常にとどまらせることである.そのルート•セグメ 
ントはより高いメモリーの中でのオーバーレイ • セグメントのロードをコント 
口ールし，ルート•セグメントの上のどこかにあるメモリーへロー ドするとき， 
各才ーバーレイ•セグメントは，低レベル•才ーバーレイ•セグメントの中の 
関数のエントリー•ポイントだけでなく，ルート•セグメントの 範囲 中でのラ 
ンタイム • パッケージのエントリー.ポイントも利用することができる（ルー 
卜 • セグメントも）. 

たいてい（たとえば，オーバーレイが使用されないときなど），実行している 
C プログラムの実行時の環境はこのようにみえる. 

low memory: base + 100h: C.CCC run - time utility package (csiz bytes) 


ram + csiz : start of program code 
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•••(program code ) … 
xxxx — 1 : end of program code 


xxxx : external variable area (y bytes long ) 
… (external data ) … 

xxxx + y : free memory , 

available for 

storage 

allocation 


????: as low as the machine stack ever gets 

local data,function parameters , 
machine stack : intermediate expression results , 

etc . 

high memory : bdos : machine stack top (grows down ) 

Memory Map 1• 

xxxx は，プログラム•コードにつづく最初のロケーションであり， y は，外 
部変数に必要なメモリ ー M である. 

才ーバーレイを組み込ませるために，まず才ーバーレイ•モジュールをどこ 
に常駐させるかを決定しなければならない.初期の BDS C のバージョンは，外 
部領域の終りから発生する局部データ•フレームを持っていた.これは，オー 
バーレイ•モジュールを安全に口ー ドするためのメモリ ー • ロケーションの決 
定をむずかしくした.オーバーレイを操作するために，提案されたことは一番 
大きなオーバ、ーレイ•モジュールの組み合わせを適応させるために，ルート • 
セグメント.コードの最後と，外部データ領域のスタートとの間に十分な余地 
を残すということである. 
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現在， BDSC は，メモリー•スタック上に局所データの領域を割り当てる. 
次にあげている修正されたメモリー • マップは，この方法のオーバーレイ操作 
を適応させている. 


low memory: base + 100h: C.CCC run-time utility package (csiz bytes) 

ram + csiz: start of root segment code 

•••(root segment code}"- 
zzzz —1:end of root segment code 


zzzz: start of overlay area 
•••(overlay area) … 
xxxx —1:end of overlay area 


xxxx: external variable area (y bytes long) 
•••(external data)". 


xxxx + y: free memory, 


available for 


storage 


allocation 


????: as low as the machine stack ever gets 


machine stack: 


high memory: 


local data, function parameters, 
intermediate expression results ， 


etc.etc. 


bdos: machine stack top (grows down) 
Memory Map2. 


ZZZZ は，オーバーレイ•セグメントがロードされる場所で，最長のセグメン 
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卜は xxxx にとどかないと保証されている . 

バージョン 1.5 において，外部データ領域の後にオーバーレイ領域をおくこと 
も可能である（しかし安全でない） . この代替的構成のためのメモリー•マップ 
は次のようになる . 

low memory: base + 100h: C. CCC run-time utility package (csiz bvtes) 


ram + csiz: 

start of root segment code 


•••(root segment code) … 

xxxx — 1: 

end of root segment code 

xxxx: 

external variable area(y bytes long) 

•••(external data) … 

xxxx + y — 1: 

end of external data area 

xxxx + y: 

start of overlay area (ssss bytes long) 

•••(overlay area) … 


xxxx + y + ssss —1:end of overlay area 

xxxx + y + ssss: < unused memory > 

????: as low as the machine stack ever gets 

local data, function parameters, 
machine stack: intermediate expression results, 

etc.etc. 

high memory: bdos: machine stack top (grows down) 

Memory Map3. 


記惊割り当て （ alloc と sbrk) は，いつも外部データの末尾の後にすぐに続く 
領域からメモリーを獲得し始める . ユーザーのプログラムの中で，記憶割り当 
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て関数 （ alloc , free ， sbrk ， rsvstk ) を使用するつもりなら， オーバ、 ー レイ領 
域のサイズである引数 ssss を持つ sbrk 関数をまずコールすることを忘れない 
ように，でなければ，記惊割り付けルーチンはオーバーレイ領域の範囲内から 
メモリーを割り当て始める. 

この文害の残りがわき道にそれたりしないようにするために，私は元のオー 
バーレイ案は，メモリー • マップ2で示されたように実施されているものとす 
る • 

BDS C に関する"ルート，，セグメントと，"オーバーレイ”セグメントの 
つくり方についてちょっと延べてみよう.まずはじめに，ルート•セグメント 
で定義されたすベての関数は，オーバーレイ•セグメントによってアクセスし 
やすいようにしたい.これは，ルート•セグメントがリンクされるときにすべ 
ての閲数アドレスを含んでいるシンボル • テーブル • ファイルをディスタに対 
し CLINK に書き出させることによって達成される. CLINK に対する 一 w 才 
プションがうまくやる.このシンボルテーブルはスワップできるセグメントを 
リンクするとき，後になって使用される. 

ルート•セグメントをリンク するとき，外部 データ 領域の ロケーションをセ 
ッ トするのに 一 e オプションを 使用しなさい.実行時で最大の オーバーレイ • 
セグメント. コードの末尾のすぐ後から 2 ”，外部 データがスタート するとみな 
し，オーバーレイ 領域と矛盾する（このように 一 e は メモリー•マップ 3で 示 
されたように2#目の オーバーレイ 案を使用しているときにのみ省かれる >• 

ルート•セグメントのコードの範囲内でスワップできるセグメントは 

swapin ( name ， addr ); /* read in a segment ". don’t run it */ 

ということによって，ディスクからメモリーへ^ロードされる.ここで， addr は 
ルート •セ グメント •コ ードの最後のバイトにつづく ロケー ションである •ユ 

21) 私は，低メモリーは” below " (下の）ハィメモリーであるという意味で** below " という単語 
を使用している.前出のメモリー•マップにおいて， below はページのトップという意味であ 
る. 
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ーザーは一 e オプシヨンを与えたり，リンク後に一 s によって出力されるサマ 
リを読んだりせずに，ルートを一回リンクすれば，この値をみつけることがで 
きる.セグメントを実際に実行するためには，関数のポインタを使用して間接 
的にそれを コールし なければならない. 

一つ例がある•我々は ptrfn と呼ばれる関数のボインタを宣言し，ロケーシヨ 
ン 300 Oh で ovll と名付けられたセグメントの中へロードする.そして，そのセ 
グメントを コールす るのである.その手順は次のようになる. 

int (* ptrfn)( ): / * can be whatever type you like * / 

ptrfn = 0 x 3000 : 


if (swapin ( ” ovll ”，0 x 3000)! = ERROR) / * ロード • エラーのチェック */ 
(* ptrfn) (args …)； /* エラーがなければ， それを コールする */ 


オーバーレイ • コードは，コールされた後に値を戻さないかもしれないが， 
関数のポインタはある神: の 型でもって宣言されなければならないことに注意し 
なさい.何も思い浮かばない場合， int を使用しなさい.上記のように，セグメ 
ン トが呼び出されるとき， コン トロールはセグメントの” main” 関数にパスす 
る.パラメタが” argc” と” argv” といった フオームの ものでなければならな 
いということは全くない.” main ’’関数に関しては，最初にコールされたとき 
に持っている性能以外，何も特別なことはない.ロー ドされたセグメントの範 
|«1 内の ” main” _数は，そのセグメントにとって許された唯一の エン トリ•ポ 
イントである. 

Swapin 関数は， STDLIB2.C に含まれている.外部データ領域上で，試みら 
れたロードを検知するには，ロケーション ram + 115h の内容を用いて，ロード 
された最後のアドレスを比較すればよい. 

もし低レベルで操作したことがないなら，铵数（あるいは，符号なし）のポ 
インタを用いた間接的方法を使用することによって，ロケーション BASE + 
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115 h の16ビットのアドレスの値を得ることになる.ロケーション BASE +115 
h は，外部データ領域の開始ロケーションに対するポインタを含んでいる. 

さて，我々は実際にオーバーレイ•セグメントをつくるということを除けば， 
すべての操作方法もわかった.オーバーレイ•セグメントは基本的には，単な 
る許通の C プログラムであり， C . CCC ランタイム•ユーテイリテイ-パッケー 
ジがオーバーレイ..セグメントの前に付加されないことを除けば，ルート•セ 
グメントと M じような” main ” 関数を持っている（ルート•セグメントにおけ 
る C . CCC ランタイムパッケージは共用される）.オーバーレイ•セグメントと 
ルート•セグメントの他のちがいは，ロード•アドレスである.ルート•セグ 
メントは常に TPA のベースからロードされるのに対し，オーバーレイ•セグメ 
ントはどこででもロードするようにつくられている•いったん，オーバーレイ • 
セグメ ン トをロードしてしまったら，それをリンクするのに CLINK コマンド 
の特別なフォームを与える. 

A > clink segment-name -v -1 xxxx -y symbol-file [-s …]く cr > 

ここで， segment - name は，セグメントを念んでいる CRL フアイルの名前で 
あり， 一 v はオーバーレイ•セグメントを作ることを CLINK に対して示してい 
る （ C . CCC が結介されないように）.そして，一1 xxxx (16 進のアドレスによ 
って続けられる文字エル）は，セグメントのためのロード•アドレスを示す•一 y 
オプションは，ルート.セグメントによってつくられたシンボルフアイルを取 
り込む.これが杏かれると，_数の新しいコピー” PRINTF ” や” FOPEN ” 
等がすでにルート•セグメントヘリンクされてしまっていたとしても ， CLINK 
はそれらを取り込む.ルート.セグメントからのシンボルテーブルを読み込む 
ことによって，ルートの中ですでにリンクされたルーチンは，才ーバー レイ . 
セグメントに対して有効にされるのは確実である.けれども，ルート•セグメ 
ントはシンボルテーブルの使用を通して，オーバーレイ • セグメントに城する 
関数について知ることはできない.それは，このパッケージの有効範 M を越え 
て互いに参照できるある穐のリンクシステムが必要となる. 

オーバーレイ•セグメントをリンクするとき，コンソール上にサマリを表示 
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するために 一 S を指定し，ルート*セグメントのシンボルファイルから読まれ 
た文字だけでなくスワップできるセグメント自身のシンボルも書き出すため 
に， 一 W を指定するかもしれない.この新しいシンボルファイルは別の レベルの 
スワッピングで使用され，そのように求められるべきである. 

例をあげると：ユーザーがプログラム ROOT . C を得たとする.これはス 
ワップ•インし SEG 1. C を実行し， SEG 1. C でもって SEG 2. C を才ーバーレイ 
する. ROOT . COM は 100 h からロードされ，300 Oh で終わる.我々は，300 Oh 
からそのセグメントをロードし，そして外部データ領域のベースを500 Oh へセ 
ットする（これは，どちらのセグメントも200 Oh より短いとみなしている）. 
ROOT のリンクは 

A > clink root 一 e 5000 — w —s く cr > 

でぁる. ROOT . COM がルート•セグメントであること（一 v オプシヨンは与 
えられなかったので)，外部領域は500 Oh から始まり， ROOT . SYM と呼ばれる 

シンボルファイルを害き出すこと，サマリは，コンソールへプリントされるこ 
とを CLINK に指定している. 

各才 ー バーレイ•セグメントのリンクは，次のようになる. 

A〉clink segl 一 v —13000 — y root — s — 〇 segl く cr > 

これは CLINK に SEG 1. COM がロケーシヨン300 Oh からロードされるオー 
バーレイ•セグメントになること（一 v があるから）， ROOT . SYM と呼ばれる 
シンボルファイルは前定義の関数のアドレスのために走査されるべきであるこ 
と.リンクの後にサマリをプリントすること • オブジェクトファイルは SEG 1 
として書き出されること （ SEG 1. COM にしないのは CP / M コマンドとして， 
偶然それを呼び出すことをさけるため）といったことを指定して いる . 
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CASM - アセンブリ言語- CRL ファイル変換プリプロセッサ 


従来の BDS C では，アセンブリ言語のプログラムから再配閬可能なオブジ 
ェクト•モジュール （ CRL ファイル）をつくるための唯一の手段は，非常に複 
雑なマクロ •アッセンブラー （ MAC . COM ) を用いて使用しなければならない 
ので， MAC を所科していないューザーは全 BDS C パッケージとほぼ同じく 
らいの赀用でそれを購入しなければならなかった.この文書は， " MAC ” の必 
要性を取り除くために与えられている解説である. CASM はプリプロセッサ 
で，非常にむずかしい CMAC . LIB よりはアセンブリ言語にもっと近いフォー 
マットで記述できる.” . CSM ” のアセンブリ言語のソース•ファイルを入力と 
して取る.そして，標準のいたるところにある CP / M アセンブラ （ ASM . COM ) 
によってアセンブルされる” ASM ”ファイルを書き出す. CASM は，自動的 
にどのアセンブリ言語命令が再配 JS パラメタを必要としているのかを認識し， 
適切な擬似操作や余分のオペコードを出てきた” .ASM ”ファイルヘインサー 
卜するので，それは正しく CRL フォーマットへ直接アセンブルする.加えて， 
基本的な論理チヱックが行なわれる.二重定義や未定義のラベルは検知されレ 
ポートされる.そして異なる関数の中の類似したラベルは認められ， ASM が異 
譏を申し立てないようにするめに独特な名前へと転換される. 

E .1 CASM . COM の生成 

CASM は ， BDS C パッケージにソース•ファイルとして含まれている.実行 
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" r 能のバージョンをつくるのに CASM . C をコンパイルする前に， ユーザーの 
システム構成に適合させるためデフォルトのライブラリ.ドライブと ユーザー 
領域の定義，もしくはその一方をセットすることによって，ファイルをカスタ 
マイズしなさい. CASM のコンパイルやリンクのための命令はフアイルの敁初 
の部分のコメントの中に含まれている. 

E.2 コマンド • ライン•オプション 

パは，入力と出力の両方でコメントの保持を可能にする.デフォルトでは 
入カフアイルからすべてのコメントを取り除く •そして最後の ASM ファイル 
を形成するときにつけ加えられたアセンブリ. コードへ コメントを入れない. 

一 c が指定された場合,オリジナルのコメントを . ASM コードの新しいセクシ 
ョンへ付け加える. 

二^ ユーザーが 古いアセンブリ ー言 語のソース.ファイルを CSM フォー マ 
ットへ転換するために占い CMAC . LIB マクロ . ライブラリ ー 演算子に印をつ 
ける. 

- 〇 name は,出カフアイルを name . ASM に指定する.浑通出カファイル 
は， . ASM 抗張名を CSM 入カフアイ ルの フアイ ル ネームに付加される. 

CASM パッケージを構成するフアイルは次のものである. 

CASM.C CASM プログラムのソース•ファイル 

CASM . SUB CSM ファイルを CRL フォーマットへ変換するためのサ 
ブミット•ファイル 

ASM . COM (または MAC . COM ) CASM の出力をアセンブルするため 
の標準 CP / M ユーティリティー 

DDT.COM (または SID . COM ) アセンブラの HEX 出力を二進の 

CRL フォーマットに変換するための標準 CP / M ユーティリティー 

CASM が ， .CSM ファイルの 中の特別な コントロール.コマンドと して認識 
している擬似命令は，次のものがある. 


I 
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FUNCTION く name 〉 各関数は FUNCTION 擬似 命令で始まらなけれ 
ばならない•ここで，く name 〉 は， .CRL ファイル•デイレクトリの中の関数の 
ために使用される名前である.他の情報はこのライン上にはあらわれるべきで 
ない CRL ファイルの生成の占い CMAC . LIB の力•法ではよくあったことだ 
が， .CSM ファイルの スター トで含まれている完全なリストを衍定するよラな 
ことは，必要でないということに注意しなさい • 

EXTERNAL く list 〉 _数が他の C かあるいは，アセンブリーコード化さ 
れた関数をコールする場合，これらの他の_数を指定している EXTERNAL 
擬似命令は FUNCTION 擬似命令のすぐ後につづかなければならない.一つ以 
I •.の名前がリストの中に税われても，そのリストは必要なだけの EXTERNAL 
に城開される.関数命令だけが EXTERNAL の行の中で現われる.データ名 

(C プログラムの中で定義された”外部”変数のように）は， EXTERNAL 
"外部’’命令文の中に配遛することができない. 

ENDFUNC 

ENDFUNCTION この命令 （| Aj 方のフォームは向じ）は，特別な_数の 
ためのコードの末/4の後に％われなければならない.その関数の名前は，オペ 
ランドとして与えられる必要はない.いま，あげられている3つの擬似操作は 
M .CSM ”ファイルのアセンブリ言語命令の中で現われる必要のある単なる擬 
似操作であり， CMAC . LIB ではよくあることだがァセンブリ命令自身が再配 
取の f こ めに変史される必要性はない. 

INCLUDE く filename 〉 

INCLUDE ” filename ” この操作は，指定されたファイルが出カファイ 
ルの税在の行からインサートされるようにする.そのファイルネームがアング 
ル•ブラケット（たとえば，く filename 〉 のように）で [ ttj まれている場合，デフ 
ォルトの CP / M 論理ドライブにその指名されたファイルを含んでいると仮定 
される（ユーザーのシステムにとって，具体的なデフォルト値は CASM . C の中 
の適切な# define を変更することによってカスタマイズされ）.そのネームがク 
ォートで W まれている場介，現在のドライブが検索される.ユーザーはたいて 
い . CSM ファイルのスタートでファイル BDS . LIB を含んでいることが望まれ 
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るということに注意しなさい.だからランタイム • パッケージでのルーチンの 
名前は CASM によって認識され，未定義の局所的な前方参照として解釈され 
ない.というのは， CASM は1パス•プリプロセッサで，オペランドとしてラ 
ンタイム • パッケージのルーチン名を持つ命令のために，不必要な再配置パラ 
メタを生成させることになるのである.擬似命令 MACLIB は INCLUDE と同 
じなので，かわりに使用される. 

•CSM ファイルのフオーマッ トは 次の よ うになる . 

INCLUDE bds.lib 

FUNCTION functionl 

[ EXTERNAL needed _ fund [,needed _ func 2] [,...]] 

code for functionl 
ENDFUNC 

FUNCTION function 2 

[EXTERNAL needed _ funcl[,needed _ func 2] [,...]] 

code for function 2 
ENDFUNC 


追加の注意とバグ 

1. ラベルは第 1 カラムから始まらなければならない.ラベルが第1カラム 
から始まらなければ， CASM はそれをラベルとして認識しないし，再配閬 
は正しく行なわれない. 

2. 再配置可能シンボルに対する前方参照は可能であるが，実行可能の命令 
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において等しいとみなされたシンボルに対するフォワード • リファレンス 
は認められない.このわけは，1 パス •プリプロセッサであり，いつでも 
前もってわかっていないシンボルが命令の中で出会うためであり ， CASM 
はシンボルが再配; s 吋能でその命令のために再配置パラメタを生成すると 
みなす. 

3. INCLUDE (と MACLIB ) は，1 レベルの 包含にだけ作動する（入れ子 
にできない）. 

4. 再配諝可能の値が dw ォペコードの中で指定される必要があるとき，そ 
れは特別な dw 命令文の中で与えられた値だけでなければならない.さも 
なければ再配置は正しく操作されない.たとえば，16ビットの再配萬可能 
の項目は， 一つの dw 命令文に つき一つ だけ認められる. 

5. シンボル名で使用される文字は英数字に限られる.ドル•サイン （$) 

も認められているが， CASM の生成したラベルと矛盾したりするかもしれ 
なぃ. 

6. CASM の出力を ASM によってアセンブルした後につくられた .HEX 
ファイルは CP / M の LOAD コマンドを使用して，二進のファイルへ変換 
することはできないかわりに， DDT あるいは， SID がそのファイルをメモ 
リ ー"^^読み込むために使用されなければならない•また， CP / MSAVE コ 
マンドは，そのファイルを. CRL ファイルとしてセーブするために使用し 
なければならない. CASM でエラーが発生したら，対応する ASM の行の 
最後に”！ ”を付加する.ファイルをメモリー^^読み込むために DDT あ 
るいは SID を使用した後，256バイトのブロックがいくつセーブされる必 
要があるのかを正確に知るためには，左はしにプリントされる値に基する. 
LOAD が使用されない埋由は CASM ファイルの末尾で CRL ファイル. 
ディレクトリを生成するためのコードを出力するからである.そして 
TPA のベースへそのロケーションのカウンタをセットするために， 
”ORG ”擬似操作を利用している.この性能を持つァウト•ォブ.シーケ 
ンスのデータに出会ったとき， LOAD コマンドは秘密のメッセージ 

"INVERTED LOAD ADDRESS ’，で打ち切る • CASM にディレクトリ 
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情報を新しいファイルへ書き出させ，この新しいデイレクトリ•ファイル 
の未尾の前の出力全体を付加させるよりも，私はむしろ SAVE コマンドを 
使用することをユーザーに要求したい. 

7. CASM . SUB のサブミット•ファイルは，最後の SAVE コマンドを入れ 
る場☆を除いて，. CSM ファイルを . CRL ファイルへ変換するための全手順 
を行なうために使用される.例えば，" FOO . CSM ”と呼ばれるファイル 
を変換するには， 


submit casm foo 


とすればよい-処理が完了したら，” SAVE ” コマンドを入力する. 
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BDS C ファイル I / O の手引き 


F.1 はじめに 

ファイルの入出力を行なうために BDS C で与えられているライブラリ関数 
は2つに分けられる.原始または低レベルの I / O 関数，そしてパ、ッファ付き I/O 
関数である. 

ァセンブリ言語の中で敁岛 の 性能を求めて コー ド化される原始関数は，すべ 
ての ファイル I / O を行う低 レベルの CP/M BDOS コールに 対する拡張された 
インターフェイス である.原始 I/O コールの 間に転送された データの M は常に 
一つの 全 CP / M 論理セクタ （128 バイト）の倍数である. 

C で咨かれるバッファ付き関数は，フィルター • タイプの応用のために特に 
適応されたバイト単位の連続する I/O システムを与える.これらは，目にみえ 
ないメカニズムがすべてのセクタ.パ、ッファリングや実際のディスク転送を操 
作するので，ユーザーが最も手頃な M がどれほどであっても，その中でデータ 
を読んだり，書き込んだりできるようにする.このようにバッファ付き I / O 関 
数は，たいてい原始_数よりも取り扱いが便利であるが，それらは実行スピー 
ドや コー ドバ ッ ファ領域のメモリースペースの消费といった点ではかなり超過 
する. 

原始 I / O 関数は，バッファ付き関数を形づくるので，まず私は原始 I / O を詳 
しく説明し，次にバッファ付き閲数へといってみよう. 
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F .2 原始ファイル丨/〇関数 

すべての原始 I / O 関数は，操作中のファイルを識別するためのファイル記述 
子の使用によって特徴づけられる.ファイル識^子 fd は，小さな整数値であっ 
てファイルが開かれたり，作成されたりする時にファイルへ割り当てられる. 

そして閉じられるまではファイルと結合したままでいる. fd は open か creat 
_数のいずれかを コールす ることによって得られる.これらの関数の使い方は， 


fd = open ( rnename , mode ); 
fd = creat ( ruename ); 


” filename ”は文字列か式のポイ 
ンタでなければならない. 


Open は，読み取りか書き込み，もしくはその両方のためにすでに存在してい 
るファイノレ（たいていは，その中のデータをいくつか持っているファイル）を 
開くために使用される. creat は，読み害きのために新しいファイルを作成した 
り開いたりするのに使用される.相方の場合， fd は，うまくいったときに呼ば 
れたプログラムによって戻される.何かエラーがあったり，指定されたファイ 
ルが作成もしくは開いたりされない場合は ， ERROR (— 1) が戻され ， error 
I 対数がファイルが開かれなかった原因をみつけ出すためにコールされる. 

すべての他の原始関数は，ファイルが操作されるように指定するため， fd を 
必要とする （ unlink と rename を除く，これらはファイルネーム•ポインタを 
必要とする）2つの非常に甫要な原始 I / O 関数， rea d と write は，128バイトの 
論理セクタの倍数でデータをディスクへ，あるいはディスクから$云送する•そ 
の典型的な使い方は， 

i = read ( fd , buffer , nsects ); 
j = write ( fd 2, buffer 2, nsects 2); 
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はじめのコールは，データの nsects 分のセクタを，その fd が指定されている 
ファイルから，ロケーション buffer でのメモリーへと読み取ろうとする • 2 つ 
めのコールはデータの nsects 2 をロケーション buffer 2 でのメモリーから，そ 
の fd が fd 2 であるようなディスク•ファイルへ書き込もうとする.エラーが起 
こらなければ（まちがった fd が与えられたり，ファイルの末/4をすぎても読み 
取りが行なわれていたりするときのように）， read と write はすぐにディスタ 
操作が 行なわれるようにする.これは， 原始 I/O とバッファ付き I/O の大きな 
ちがいの一つである. 原始 関数はいつも行ないたいことが " T 能で ある限り，フ 
ァイル I / O にすぐ活動させるようにする が 22 、パッフ ァ付き関数はパ、ッファが 
いっぱいになったとき（書き込みの間），あるいは消耗してしまった（読みの問） 
ときに，デイスクアクセスをする. 

原始 I/O のために開かれた各ファイルと結合している目にみえない" r/w 
ポインタ”がある.このポインタは次に絞くセクタのトラックをファイルから 
説まれ，あるいはファイルへ害き込まれるためにキープする.ファイルが開か 
れたすぐ後に r / w ポインタは0に初期化される（ファイルの第1のセクタ）•そ 
れはうまく •送されたセクタのナンバーによって read や write のコールをつ 
づけ， A 動的に增加される.だから，省略時解釈によって，各データの転送は 
前の fe 送が終わった地点からピック.アップする.ファイルの r / w ポインタの 
侦は tell _数によって戻され， seek 関数を使用することによって修正される • 

プログラムの中で原始 I / O の使い方を解説するには，ファイルのコピーをつ 
くるために単一のユーティリティーをうち立ててみるとする.このユーティリ 
ティー（我々は " copy ” と呼んでいる）のためにコマンド•フオーマットは次 
のようであるべきである. 


22) はとんどの CP / M のシステムでの®始ファイル I / O コールは，ディスク.ドライブのハード 
ウェアはすぐに活的できるようにする.あるシステムでは BIOS がセクタのバファリングをす 
るが， ft 々のそしてすベての哚始 I / O コールのために物坪•ディスタを動かす必要はない. 
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A > copy nllname newname く cr > 


” copy ”は” filename ”によって指名されたファイルであり ，" newname ’’と 
呼ばれるそれのコピーをつくる.これは上質のユーティリティーであるべきな 
ので，うまくいかない場合には，十分なエラー診断が必要である（ディスク. 
スペースがなくなったり，マスター • ファイルがみつからなかったりした場合 
など）これは正しい数のパラメタがコマンド•ライン上にタイプされたことを 
確認する検査を含む.半分 C / 半分英語の擬似コード•フォームを用いて，プロ 
グラムを要約するのはときには便利なものである.これはフローチャートのよ 
うなものであるが，”条件や制御の箱”を使ったものではない.次のものはそ 
のようなコピー.プログラムの要約である. 

copy ( filel , file 2) 

{ 

it (exactly 2 args weren’t given ) 

complain and abort 
if ( can’t open filel ) 

complain and abort 
if ( can’t create file 2) 

complain and abort 
while (not end of filel ) { 

Read a hunk from filel and write it out to file 2; 
if (any error has ocurred ) 

complain and abort 

{ 

close all files ; 


そして，コピー操作をするための実際の C プログラムは次のようになる. 
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# include < bdscio . h > /* The standard header file * / 

# define BUFSECTS 64 /* Buffer up to 64 sectors in memory */ 

int fdl , fd 2; / * File descriptors for the two files * / 

char buffer [BUFSECTS * SECSIZ ] ; /* The transfer buffer */ 


main ( argc , argv ) 

int argc ; / * Arg count * / 

char * * argv ; / * Arg vector / * 

{ 

int oksects ; / * A temporary variable * / 

/ * make sure exactly 2 args were given * / 

if (argc ! = 3) 

perror (” Usage : A > copy filel file 2 く cr>\n ”）； 


/ ^ try to open 1 st file ; abort on error ホ/ 
if ((fdl = open (argv [1],0) )= = ERROR ) 

perror (” Can’t open :% x \ n’’，argv [1]); 

/ * create 2 nd file,abort on error : * / 
if (( fd 2= creat(argv [2] ))== ERROR ) 

perror ( " Can’t create :% s\n ’’ ， argv [2]); 


/* Now we’re ready to move the data : */ 

while ( oksects = read ( fdl , buffer , BUFSECTS )) { 
if ( oksects = = ERROR ) 
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perror (” Error reading :% s\n ” , argv [1]); 
if (write ( fd 2, buffer , oksects )! = oksects ) 

perror ( " Error ; probably out of disk space\n ”）; 

} 

/* Copy is complete . Now close the files : */ 

close ( fdl ); 

if (close ( fd 2)= = ERROR ) 

perror (” Error closing % s\n ”，argv [2]); 
printf (Copy complete\n ”）； 

} 

perror ( format , arg ) / * print error message and abort * / 

{ 

printf ( format , arg ); /* print message * / 
fabort ( fd 2); / * abort file operations */ 

exit ( ); / * return to CP/M * / 

} 

さて，このプログラムをみてみよう.最初に宣言である.コピー処理に伴う 
ファイルのファイル記述子が必要である.そしてデイスタ • ファイルのデータ 
をバッファするための大きな配列をメモリーに割り付ける. パ、ッ ファのサイズ 
は，パ、ッファされるセクタの数（プログラムの先頭で定義されている BUF - 
SECTS ) とセクタの大きさ （ BDSCIO . H の中で定義されている SECSIZ ) を掛 
けた値である. 

main 関数においては，まず最初に正しい数のパラメタがコマンド行でタイ 
プされたことを確認する.” argc ”パラメタは，各々の main プログラムに対し 
てランタイム•ハ。ッケージによって自由に与えられていて，常に与えられてた 
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パラメタの数に 1 をプラスしたものと等しいので，それが3に等しいことを確 
認する（これは2つのパラメタが与えられた場合). argc が3に等しくない場 
合，不服を申し立てそのプログラムを打ち切るために perror を コールす る. 
perror はその引数が printf コールに対する最初の2つのパラメタであるかの 
ように，それらを理解し，要求された printf コールを 行ない，出カ ファイル 23 > 
での操作を打ち切り， コマンド •レベルに戻る. 

argc テストを終えたら，次はファイルのオープンを試みるときである.次の 
命令文は読み取りのためにマスター•ファイルを開き， open によって戻された 
ファイル記述子を変数" fdl ” へ割り当て，そして open がエラーを戻したな 
ら，そのプログラムは打ち切られるようにする.これは， C の式•評価子のお 
かげで一度にすベて行われる.一つの命令文の中でこういったたくさんのこと 
が起こるのを見ることに惯れていない場合，注意深く調べるためにしばらく間 
を取りなさい•まず， open へのコールがなされ， open からのリターン値が変数 
” fdl ”へ割り当てられ，それからその値が ERROR であったかどうかを知るた 
めにテストが行われる.その値が ERROR に等しくなかった場合，そのファイ 
ルは正しく開かれたので，コントロールは次の if 文へパスされる.でなければ， 
perror に対する適切なコールがぞの問題を診断し，そのプログラムを終結させ 
る.出カファイルの作成は，似たパターンをつづけ，ファイル作成を試みたが 
エラーを戻したという場合には， perror コールを用いて問題を診断する. 

準備が全部できたら（いよいよ！）.データのコピーを始めるときである 
while ループを使用するごとに，我々は得られるだけのデータ （BUFFSECTS 
セクタ数まで）をマスターファイルからメモリーへ^読み込む. read 関数は，う 
ま〈読まれたセクタの数を戻す.これは，0 (ファイルの終りの条件を示して 
いる）から要求されたセクタの数（この場合， BUFFSECTS ) までの範囲で， 
アクシデントがあったとき（デイスタ•ドライブのドアーが開いてしまったり） 
には ERROR の値を戻す. 

23) これは，ファイルが開かれる前にコールされると効果がない.例えば，まちがった数のパラ 
メタが与えられてしまって， " argc ! =3 "のテストが成り立ったときのように. 
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この値がどんなものであっても，後の試験のために" oksects ” に割り当てら 
れる.これがゼロに等しいような場合， while ループは退出される.さもなくば， 
我々はそのループに入り，読み込まれたデータを書き出そうとする.だが，我々 
は最初にとんでもないエラーが起こってないかを確認したい.だから ， ERROR 
が read コールによって戻されたかどうかを見るためにチェックが行なわれ 
る.もしそうであれば，中断する•なにもエラーがなければ我々はそのデータを 
出カファイルへ書き出すために write をコールする.書きたいセクタの数を正 
確に書き込むのに成功しない場合は，それは適切なエラー•メッセージを表示 
し中断する（ほとんどの書き込みエラーはデイスタ.スペースがなくなること 
によって起こる）. write が成功した場合，ループの最初にもどり，もっとデ ー 
夕を読み込もうとする.このプロセスはすべてのデータを読み取り，書き込み 
されてしまうまで続く.このとき read 関数がゼロを戻したら，コントロールは 
while のループの手から離れる. 

いったん while ループが離れてしまったら，最後に行うことは，ファイルを閉 
じることである.出カファイルが正しく閉じたことを確•認しプログラムは終了 
する. 

F .3 バッファ付きファイル I/O W 数 

先程のセクシヨンで表わされた原始ファイル I / O 関数は，多量なデータを操 
作するようなときに最も有効である.前のファイル • コピーのプログラムは典 
型的な一つのアプリケーシヨンである.原始ファイル I / O はユーザーが常にセ 
クタという単位からみて考えるように要求する.これはファイルコピーの例に 
おけるように，特殊な問題は持ってないが，ビットやランダムなサイズのデー 
夕を扱うときにごく少しだが複雑なものを加える必要がある.たとえば，テキ 
スト•ラインとして知られるユニットを考えてみると， ASCII データの一行の 
長さは，1バイトから（空白ストリングの場合 NULL によってのみ表わされる） 
130パ M 卜かあるいはもっとあるかもしれない•デイスクフアイルへこれらのテ 
キスト行をあるいはデイスクフアイルからこれらのテキスト行を読んだり，書 
いたりするのに便利な方法は，テキスト処理のアプリケーシヨンにとって大変 
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便利なものである.理想的にいえば，我々はテキスト行のポインタと共にある 
種の記述子をパスして単一関数をコールしたい•そしてその関数にテキストの 
行を最後に書かれた行につづくファイルへ書き込みたい.また，一行がかかれ 
るごとに時間を浪费するディスク.アクセスを防ぐためには我々の関数に，多 
くの行をバッファさせバッファが満たされると，すぐそれらの行全部をディス 
クへ書き込ませるとうまくいく.同様にファイルからメモリ ーへ ^テキストの行 
を読み込む関数がなければならない.もし，ディスク動作が最小限におさえら 
れるように目にみえないバッファがテキスト行を保つ関数によって処理される 
場合，それは非常にその性能を改善する.いま延べられた関数は事実，標準ラ 
イブラリの fputs や fgets である.これらはバッファ付き I / O 関数の2つの例 
である. 

バッファ付き I / O の特徴は，論理的な I / O バッファと呼ばれる構造体を持っ 
ていることである.この構造体の中には，転送されるデータを記惊する大きな 
文字配列があり，またバッファのデータ配列部分の中で起こったことを見のが 
さずに党えておくためにいくつか組み合わせたボインタや記述子がある.これ 
らは原始 I / O 操作のためのファイルを識別するファイル記述子，次のバイトが 
咨き込まれたり，あるいは読み取られたりする場所を教えるためのデータ配列 
のポインタ•カウンターが，パ、ッファを再ロードしたり，書き出したりする必 
要があるようになる前に，データか スペース （読み取っているか，害き込んで 
いるかにかかわってくる）のいずれかのバイトが，どれほど残されるのかを教 
えるためのカウンター，それから最後に，ファイルが閉じられるときに事がう 
まく速ぶように入力あるいは出力のために使用されているかどうかといったよ 
うなことを記憶するバイト，これらのものを含んでいる.バッファ付き I / O 関 
数はまさに，原始ファイル I / O 関数がファイル記述子を使用するように操作さ 
れているファイルのための識別として，これらの I / O バッファに対してポイン 
夕を使用する. 

準 •ー バイ トの データ や文字のために，実際の バッファ 付き I / O を実行する6 
つの関数がある.他の バッファ 付き I / O 関数 （ fputs や fgets のように）は，こ 
れらの6つの"中堅”関数を用いてそれらの仕事を行う. 
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ファイル読み取りのために， fopen , getc , fclose といった関数がある . Fopen 
は既存のディスタ•ファイルを開くためにコールされ，そのファイルをユーザ 
一の与えた I / O バッファと結合させ，ファイルから受け取ったデータのために 
そのバッファを初期化する. Getc はデータ配列が空であるとわかるときは，い 
つでもディスク • ファイルからデータ配列を必ず詰め替えて， パ、 ッファから単 
ー バイト（文字）を取り出す.そして，物理的なファイルの終りに達したとき 
に，特別な EOF の値 （一1) を戻す. Fclose は， I / O バッファと連合したファ 
イルを閉じ，他のファイルを使用するためにバッファを開放する. 

ファイル書き込みのためには ， fcreat pufc , fflush , fclose といった _ 数が 
ある （ fclose は双方に成立する）. fcleat は新しいファイルをつくり，出カデー 
夕のために連合した I / O バッファ構造体を準備する • putc へのコールによっ 
て， 一 回につき1バイトのデータをバッファへ書き込む. putc コールによって 
バッファがいっぱいになったときは，いつでもその パ、 ッファはディスタへ書き 
出され，他のデータを受け入れるためにリセットされる.データすべてがファ 
イルへ書き込まれてしまったとき， fclose は連合したファイルを閉じることに 
よって処理をし完結させる.出カファイルのために fclose は，ディスク•ファ 
イルが閉じられる前にディスク.ファイルに対して，まだ十分でない I / O バッ 
ファの内容をダンプ•アウト（”フラッシュ’’）するために，まず fflush を自 
動的にコールする. 

実際にデータを読み書きする関数は， getc と putc である. fgets ， fputs , 
fprintf などの関数は， getc と putc によってその読み書きを行なう. 

BDSCIO . H ヘッダーファイルを調べれば，パ、ッファリングに使用されるセ 
クタの数は， 8であるということに気付くであろう.この値は，異なるシステ 
ムにおける最適パフォーマンスのために ユーザー によって，変更されるという 
ことができる.たとえば，1024バイトの物理セクタディスク•フォーマットを 
持つ CP / M システムで ， BDS C を使用している場合，パ、ッファ付き I / O 関数 
によってなされたバッファリングの1024バイトはたぶん不必要であり，8セク 
夕から1セクタまでのバッファリングを変えることによって，実行スピードで 
重要なロスをせずにごくわずかだがメモリーをセーブする.だが，8インチ標 
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準 128 バイトの物理セクタを実行する CP/M システムでは，デフオルトの 1 K 
バッファ') ング案は本当に処理をスピードァップする. 

最初に簡単な例をみてみよう.次のプログラムは一番左のマージンに行番号 
を付けてコンソールにテキスト•ファイルをプリント•アウトする. 

/* 

PNUM . C:Program to print out a text file with 
automatic generation of line numbers . 

*/ 

# include < bdscio.h > 

main ( argc , argv ) 
char * * argv ; 


char ibuf [ BUFSIZ ] : 

/* declare I/O buffer 

*/ 

char linbuf [ MAXLINE ]; 

/ * temporary line buffer 

*/ 

int lineno ; 

/ v line number variabele 

*/ 


if (arge ! = 2) { /* make sure file was given */ 

printf (” Usage : A > pnum filename く cr>\n ”）; 
exit (); 


if (fopen (argv [1], ibuf )= = ERROR ) { 

printf (” Can’t open % s \ n ” , argv [1]); 
exit (); 
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lineno = l; / * initialize line number * / 

while (fgets (linbuf, ibuf)) 

printf (” ％ 3d:%s ” ， lineno + +,linbuf); 

fclose (ibuf); 


ibuf は， fopen, getc，fclose 関数で利用される I/O バッファ 領域である. 
BDSCIO. H の 中で定義された シンボル 定数 BUFSIZ は， I/O バッファが どれ 
程のバイ トを含んでなければならないかを教える.この値は上で示されたよう 
に データのバッファリングに 必要な セクタの 数によ って 変わる. 

引数カウントをチェックし，バッファ付入力のために指定されたファイルを 
開いた後に，すべての本当の作業が単一の while 文の中で実行される.まず， 
fgets 関数は，ファイルからテキストー行を読み取り，それを linbuf 文字配列の 
中へおく.ファイルの末尾に出会わないかぎり， fgets はゼロ以外の（真の）値 
を/乂し， while 命令文のボディが実行される.そのボディ ーは printf への単ー コ 
ー ルで成り立っていて，その中では現在の行番号を コロン，スペース， 現在の 
テキスト行によって続けられ，プリント•アウトされる • lineno の値が使用さ 

れた後に，それは次の繰り返しの準備のために （+ + 演算子によって）增加さ 
れる. 

読み取りと プリン トの サイクルは， fgets がゼロを 戻すまで続き，その地点で 
wrile ループをぬけ出し， fclose をコールして処理を完結させる . 

最後の例で，フィルターとして知られるある種のプログラムを紹介する•普 
通，フィルターは入カファイルを読み取り，そこである種の変換を行い，新し 
い出カファイルへその結果を書き出す.その変換は （ C のコンパルのように） 
きわめて複雑であるかもしれない.あるいは入カテキスト.ファイルを大文字 
に変換するのと同じくらい些細なことかもしれない.近頃，印刷料はかなり 高 
いので，時間節約のため， C のコンパイラーはとばし，大文字変換のフィルタ 
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一 • プログラムをみてみよう . 

/* 

UCASE. C:Program to convert an arbitrary input text 
file to upper-case-only. 

*/ 

# include <bdscio.h> 

main (argc, argv) 
char * * argv; 

{ 

char ibuf [BUFSIZ] , obuf [BUFSIZ]; 
int c; 

if (arge ! = 3) { 

printf (” Usage: A>ucase file newfile く cr>\n ” ); 
exit (); 

} 

if (fopen (argv [1],ibuf) == ERROR) { 

printf (” Can’t open %s\n ”，argv [1]); 
exit (); 

} 

if (fcreat (argv [2] , obuf) == ERROR) { 

printf (” Can’t create %s\n ”，argv [2]); 
exit (); 


while ((c = getc (ibuf')! = EOF && c ! = CPMEOF) { 
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if (putc (toupper ( c ), obuf )= = ERROR ) 

printf (” Write error ; disk probably full\n ”）; 
exit (); 


putc ( CPMEOF , obuf ); 
fclose ( obuf ); 
fclose ( ibuf ); 


今问は処理されるのに 2 つのバッファ付き I / O ストリ ームが ある.入カファ 
イルと出カファイルである.最初の仕事は，正しい数のパラメタがコマンド行 
で与えられたかどうかをチェックすることである.この場合，我々は2つのパ 
ラメタを必要とする.既存する入カファイルの名前と，作成される出カファイ 
ルの名前である.それから，バッファ付き I / O のための2つのファイルを開き， 
作成するために fopen と fcreat がコールされる.それがうまくいったなら， 
main ループに 入り，楽しいことが始まる. 

ループの各々の繰り返しのときに，単一のバイトが入カファイルから取り出 
され2つのテキスト•ファイルの終りの値， EOF と CPMEOF と比較される. 
普通テキスト•ファイルの中の最後のものは ， CPMEOF (コントロール Z ) の 
記号である.しかし，そのファイルが偶然，セクタ境界線上できっちりと終わ 
った場合，あるテキスト•エディタはファイルの終りに CPMEOF 記号を3? く 
ことをしない.この場合， CPMEOF はみつからないので，物理的なファイルの 
終りの値 ( EOF ) を検知しなければならない.この処理は多少複雑である . getc 
によって戻された EOF の値は一1であり，これは16ビットの値として表わさ 
れなければならない . BDS C での char 変数は負の値を持つことができないの 
で，変数” c ”を char のかわりに int として宣言する•もし，それが char とし 
て宣言されると次式 



c = getc (ibuf) 
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は， char の値になるので， EOF と等しくなることはあり得ない•そういった場合 
に， getc が EOF を戻した場合，” c ，，は 255に等しいままで終わる（値 EOF の 
低位8ビットの char 解釈).このように” c ”は EOF の比較が意味のあるよ 
うにするために， int として宣言される.これは具合がよいものでない.という 
のは” c ”はここでは文字を保有するために使用されているからで，それが文 
字変数として宣言されるようにするとよい.実際にそれを行う方法がある•そ 
の比較の中で EOF 力す255 へ 変更されたなら，” c ，，は char として宣言されな 
ければならないし，そのプログラムは[実際の16進の FF (10 進の255〉バイト 
に入カファイルの中で出くわすときを除けば]作動する.さて，ユーザーの平 
均的なテキスト•ファイルの中に16進の FF バイトがないと想定するのは，とて 
も安全なかけであるが 例外は ある.また，フィルターがテキスト • ファイルの 
ためだけに#き込まれうるという規則はない.二進ファイルをアンロードし， 

インテル . フオー マッ トの HEX ファイルを作成するプログラムを考えてみな 
さい.敁初の16進の FF に出くわしたとき，処理を停止したいと思うだろうが， 
ノーである.もともとの方法は明らかに最も一般的なものである. 

ファイルの終りに出くわさなかったと決定した後， while 命令文のボディー 
が実行される.ここで我々は， getc からえた文字を大文字に変換するために 
toupper を使用する • それから，出カファイルへ出てきたバイトを書き出すため 
pufc を使用する.適切であるかどうかをみるのに エラーをチヱック する. putc 
が ERROR を戻す場合，そのプログラムは終結する. 

ファイルの終りの条件が検知されると，すぐ我々は出カファイルを終結する 
ために，最後の CPMEOF (コントロール Z ) 記号を書き出す.このプログラム 
の手法では， CPMEOF は入カファイルが CPMEOF で終わっても終わらなく 
ても，出カファイルへ付加される.最後に fclose は入力/出カファイルを閉じ 
るために使用される. 

バッファ付き I / O の使い方について大がかりな例をみるなら， CASM . C を 
みなさい • また，何度かファイル BDSCIO . H , STDLIB 1. C , STDLIB 2. C を 
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調べてみなさい.これらは， パ、 ツファ付き I / O 関数全部のソースを含んでいる 
STDLIB 1. C は，バッファ付き I / O ライブラリの一般的なバイト単位の処理の 
部分を含んでいるし， STDLIB 2. C はライン単位の処理やフォーマツト変換関 
数を含んでいる. 



付録 G 


BDSC コンソール I / O のひっかかりやすい点の解説，実例 


G.1 はじめに 

この文書の中で私は CP/M コンソールの入力/出力のメカニズムの背後に 
ある不可思議な部分を取り除き， BDS C プログラムからどのようにしてその 
メカニズムを最良に利用するかを示そうと思う. 

ここで一番重要なポイントは， CP/M の BIOS と BDOS によって直接，コン 
ソール入力，コンソール出力をするためにどのようにして bios と bdos のライ 
ブラリ_数を使用するかという点である.標準ライブラリの中で与えられた 
getchar/putcher 関数を使用するかわりに，コンソール I/O のために CP/M の 
BIOS へと直接行く一つの理由は， CP/M BDOS と getchar/putchar 関数（こ 
れはそれらの仕事をなすために BDOS コールを使用する〉の両方によってある 
ASCII 文字の予期せぬ妨害をさけるためである.ある適切なアプリケーション 
は テレコミ ユニケーシヨンのプログラムやゲームそして標準 getchar や put- 
cher 関数が与えるのよりも，もっと直接的なコントロールをコンソールに求め 
ているプログラムなどである. 

BDS C (たとえば ユーザーズ •ガイド）のための主な文書が，数年前に準備 
されたとき，私はどのようにして BDOS と BIOS を通して直接コンソール I/O 
を実行するために， bdos と bios ライブラリ関数が使用されるのかを，すべての 
ユーザーが 理解するのかというつ ま らない憶測をしていた. そ ういった目的の 
ための bios と bdos 関数の使い方は， CP/M システムのプログラマーに とって 
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は自明のことであり， アセンブリ あるいは マシン 言語の プログラムから CP/M 
コンソールを ドライブしたことのある プログラマにとっても そうである. 

G .2 基本コンソールインターフェイス 

コンソール I / O の間で何が起こるのか，あるいはそれをどう コント ロールす 
るのかをみてみよう. 

コンソールコントロールのソフトウェアの最低レベル（最も簡単な）は CP/M 
の BIOS (基本入力/出カシステム）の中にある.コンソールの文字を読み 
取ったり，書き込んだりするのを処理する3つのサブルーチンがある.： 
CONST (コンソールステータスをチェックする ） CONIN (文字がコンソール 
からタイプされるのを侍つ ）， CONOUT (コンソールに文字を出力）アセンブ 
リ言語レベルから，これらのサブルーチンの位置指定をする方法はむしろ複雑 
である.だから ， BDS C ライブラリは C プログラムから BIOS サブルーチンを 
アクセスするのをかんたんにする bios 関数を含んでいる. 

BIOS のべクトル2, 3, 4はコンソール装置と直接コミュニケートするため 
に使用される•式 bios ( 2 ) は， bios の中で CONST サブルーチンへの値を戻す. 
あるいはそうでない場合はゼロを戻す. bios (2) がある文字が準備されている 
と示した後にその文字を実際に読むためには，あるいは文字が準備でき，それ 
を読み取るまで待つためには CONIN サブルーチンをコールし，コンソールか 
ら文字を戻すのに bios ( 3 ) を使用しなさい.コンソールへ文字 c を直接書き込 
むためには， CONOUT をコールするのに bios (4, c ) 使用する.だが， BIOS は， 
C プログラムが単一の”ニューライン，，記号 （，\ n ，）によってキヤリッジリ 
ターン/ラインフィードの組み合わせを表わしていることに気付いていない. 
bios (4, f ' n ’） のコールは,箏一のラインフィード記号 （ ASCII の十進値 10) だ 
けがキヤリッジ*リターンなしにコンソール上にプリントされる.直接コンソ 
ール I / O を使用しているとき，コンソール出力の最初のけたにゆくために 
CONOUT サブルーチンへキヤリッジ.リターン （*\n ’） とニューライン 
r\n ’） の両方を送る. 

そういった手順は次のようになる. 
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bios (4，’ \ r ’ ）； / * send carriage-return to C0N0UT * / 
bios (4, ’ \ r ’）； / * send linefeed to CONOUT */ 

すべてのコンソール I/O は， 3 つの BIOS サブルーチンによって実行される 
が，全コントロールがコンソール装置上に要求されているときこれが異なる 
CP/M システムの間でプログラムをうごかす唯一のアプローチの仕方である 
ことを確認している 24 >. 


G .3 BD 0 S とその複雑さ 

コンソール I/O の次に高いレベルのインターフェイスは， BD0S (基本デイ 
スタ 0S) である.コンソールでのインターフェイスを行うために， 3 つの基本 
BIOS サブルーチンがあるのと同じように，よく 似た作業を 行うためによく 似 
た 3 つの，しかし，"より高いレベル”の BD0S がある.これらの BD0S フ 
アンクシヨンは， BIOS のものとは明らかに遠う BD0S 自身のコード•ナンバ 
一を持っている • コンソールから文字を得るための Console Input (BD0S フ 
アンクシヨン 1), コンソールへ文字を書き込むための Console Output (BDOS 
フアンクシヨン 2), コンソール入力から手に入る文字があるかどうかを決定す 
る Get Console Status (BDOS フアンクシヨン 11) 

標準 C ライブラリ関数 getchar と putchar がコール されるときはいつ でも， 
それらは BDOS コールを 用いてぞの作業を行う.これは次に BIOS コールを 通 
して操作を行い，ひどい混乱へと導く. BDOS の操作は ユーザーが まだ十分気 
付いていないようなこと をユーザー のためにあらゆる種類にわたって行ってく 
れる•たとえば BDOS コンソール 出カ コールでコントロール S の記号が コンソ 
ー ルから 入力されると， コントロールがも との出カ コールから 戻る前に別の記 


24) たとえそうでも，どんな種類の端末が別のシステムによって使用されているのかを知る方法 
はない一だから " 本当にポータブルな ” ソフトウェアが使用されている表示端末の神.類につ 
いて仮定するか（それがカーソルのアドレッサブルかそうでないか，そのカーソルをどのよう 
にしてアドレスするかなど），あるいは，敁後のユーザーがそのシステムに偶然リンクさせたの 
がどんなタイプの端末であっても，フィットさせるために自己修正用の準偏を含んでいるかの 
いずれかである . 
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号が入力でタイプされるまでストップする.ユーザーの C プログラムへその特 
徴をコードする必要もなく長いプリントアウトをストップしたり，スタートし 
たりする能力をユーザーが欲している場合，これはよいかもしれない.しかし， 
コントロールー s を含むコンソール上にタイプされた各々の文字をみる必要が 
ある場合，大きな問題を引き起こす. BDOS がこのことをどのようにして行う 
か.ということに関して，ほんの少し知っていれば，いくつかのおもしろいこ 
とがわかる. BDOS はコンソール入力でコントロール S を検知できなければな 
らないので，それは文字がタイプされてしまったと見るときは，いつでもコン 
ソールを読まなければならない.文字がコントロール S のように特別な処理を 
必要とするものの中にあるのでなければ，次の " Console Input ”コールが何事 
も起こらなかったのごとく文字を戻すために，その文字は BDOS に対して内部 
のどこかでセーブされなければならない. "Get Console Status ” （” console 
Input ” に対して何かがなされる前）に対してユーザーが行った続いておこるコ 
ー ルが文字が有効であることを示しているのを BDOS は確認しなければなら 
ない.これは BDOS のコールが文字が有効であると言うかもしれないような条 
件へ達する.しかし，符号する BIOS コールは物理的でない.というのは文字 
は先の BIOS との相互作用の間に BDOS によって，すでに取り出されているか 
らである. 

もし，こういったことすべてが混乱しているような感じがするなら，私が何 
が起こっているのかを把握できるようになる前には， CP/M やコンパイラの初 
期の頃のバージョンと取り組んで数力月もかかったということを心にとめてお 
きなさい. getchar と putchar のライブラリ•バージョンはユーザーがコンソー 
ル上に絶対的な直接の コントロールを必要と しないような環境のためにデザイ 
ンされた. BDOS はすでにい〈つかよいことを行うので（コントロール S の処 
埋のように），いくつか追加の特徴を延べることにする.出力時に* \ n ’ 記号 
を CR-LF の組み合わせに自動的に変換する（長い，あるいは無限の望まざるプ 
リントアウトがそのマシーンをリセットせずにストップされるためにコンソー 
ル入力操作が行われてないときでも）コントロール C が入力時に検知されると 
き，自動的にプログラムが終結する.入力時にキャリッジ•リターン記号が 
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n ，へ自動的に変換される.ある初期の頃のユーザーは putchar をコントロー 
ル C から免除されるようにしたいといったので，彼のために私は putch ライブ 
ラリ関数をつけ加えた•これはコンソールでタイプされたときにコントロール 
C がそのプログラムをストップしないということ以外は， putchar と同じよう 
に作動する.その少し後になって CP / M が物理的コンソール入力をサンプリン 
グするのを防がなければならないとき， putchar も putch の両方が妥当でない 
ということが明らかになった.この地点で私は， bios 関数をつけ加えた.それ 
でユーザーは BIOS を通して，庚接 I / O をできるようになり，全体に無益な記 
号食いの BD 0 S をバイパスする. 

私は始めの頃にいくつかの例をあげるといったのでそちらに移ってみよう. 
まず最初に bios 関数によって，3つの基本的なコンソール操作を行う.非常に 
基本的な関数がセットになっており，特別な変換もさまたげも全くない.たと 
えば， *\ n ’ — CR - LF のようなものはない. 


/* 

Ultra-raw console I/O functions : 

*/ 


getchar ( ) / 平 get a character from the console * / 


return bios (3); 


/* return true ( non - zero ) if a character is ready 



kbhit () 


return bios (2); 
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putchar ( c ) /* write the character c to the consol * / 

char c ; 

{ 

# 

bios (4, c ); 


これらの超原始的な関数は， BIOS のコンソールサブルーチンに対して直接 
のアクセスを与える以外は何もしない . DEFF 2 .CRL (これはついでながらアセ 
ンブリ言語で書かれており， DEFF 2 A . CSM のソースフオームの中にある）の 
中で与えられた標準バージョンのかわりに，それらを使用するためには，単に 
それらを（あるいは，お好みのバージョン）を含んでいる C のソース•ファイ 
ルを作成し，ファイルをコンパイルし，ユーザーのプログラムと出てきた CRL 
ファイルとをリンクしなさい. 

さて，コンソール I / O 関数のカスタマイズされたバージョンに取り組むこと 
ができるような，もっと洗練されたゲームを考えてみよう.手始めに，前に延 
ベたライブラリ•パ、ージョンのようなニューライン変換を行う度接コンソール 
I/O 関数のセットをデザインしてみよう.そしてコントロール C で実行を打ち 
切りなさい.しかし，コントロール S の規約を無視しなさい.そして，出力の 
間にタイプされた文字がコントロール C 以外ならそれを拾てなさい.コントロ 
ー ル C ならば我々がここで必要としていることは，上記の概略の間とそれプラ 
ス，次の条件を操作するためのコードである. 

a) 出力時に単一の ， \n ’記号を CR と LF へ変換する. 

b ) 入力時に CR をニューライン r\n ，） にコントロール Z を 一 1に変換 
する. 

c ) コンソールへ 入力を自動的に エコーす る. 

d ) 入力と出力の両方のときにコントロール C でリブートする. 

次にあげているのは，やや意地悪であるが， 
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/* 

Vanilla console I/O functions without going through BDOS : 

Note that * kbhit ’ would be the same as the preceding 
ultra-raw version ) 

*/ 


# define CTRL _ C 0 x 03 / * control-C * / 

# difine CPMEOF Oxla /* End of File signal ( control - Z ) */ 


getchar () 


* get a charcter , hairy version * / 


char c ; 

if ((c = bios (3))= = CTRL C ) bios ( l );/* on Ctl - C , reboot * / 


if ( c = = CPMEOF ) return —1; 


if(c 


へ r，）{ 

putchar r\r ’）; 

c = へ n ，： 


putchar ( c ); 
return c ; 


/ * turn Ctl-Z to - 1 * / 

/* if CR typed , then */ 

’ * echo a CR first , and set * / 

/ * up to echo a LF also * / 

/ * and return a ’ /n ’ * / 

/ * echo the char * / 

/ * and return it * / 


putchar ( c ) / * output a character , hairy version */ 

char c ; 

{ 

bios (4, c ); /* first output the given char */ 

if ( c = = ’\n ’） / * if it is a newline , * / 

bios (4 ， f \r ')); / * then output a CR also * / 
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if (kbhit ( )&& bios (3)= =CTRL C ) / * if Ctl-C typed , */ 


bios ⑴; 


/ * then reboot * / 

/ * else ignore the input completely */ 


さて，もしあなたが コントロール S の処理とプッシュ•パ、ックの特徴（この 
2つは実際によく関連している.というのは ユーザーは， 出力時に検知される 
かもしれない コントロール S を除いて，何でもプッシュ•バックできなければ 
ならないから）をつけ加えたいのなら，関数の最後のセットへ外部の"状態’’を 
付け加えることができ， コンソール 入力でみることを党えておくことができた. 
けれどこれが行われると， ユーザーが 行ったことはもとの標準ライブラリ•バ 
ー ジョン getchar と putchar (これは BDOS を使用する）とほとんど同じ関数 
になる. ユーザー はまたこれらを使用したにすぎないのかもしれない. 

いままで私が延べてきたすベてのことは， BIOS の見地にたってのことであ 
った.そしてすベての CP / M システムに対して同様に与えている.連悪く， 
BIOS のサポートしていない実時問の対話型の操作を書くために，しばしば必 
要とされるコンソール操作が一つあって， CP / M でそれを実行するための方法 
がない.欠けているものはコンソールが出力文字を受け入れる準備のできてい 
る場合に， BIOS を求める方法である.これが欠けているために起こる問題の一 
つの例はサンプルプログラム RALLY . C (BDS C ユーザーズ•グループから手 
に入る）でみられる.そこではそのプログラムはどんな瞬間でもキーボードか 
ら入力を読むことができなければならない.そしてそこに送られたデータの敏 
がそれ以上の記号を拒否させ，そして記号が送られるようになるまでプログラ 
ムのコールを閉鎖させるようなときに，端末を待つのを拘束するようになる余 
裕がもてない.コンソールへ記号を送る唯一のしかるべき方法は ， CONOUT 
BIOS コールを通して与えられており，そういったコールはどんなときでも，許 
容以上の長さでプログラムをタイ.アップするかもしれない.唯一の頼みのつ 
なは， CONOUT を完全にバイパスし，より洗練されうる C の中でカスタマイズ 
された出カルーチンを構成することである.これはオブジェクトコードの可搬 
性を犠牲にして， RALLY . C の中で行われる. ユーザーは 各々，独特のポート • 
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ナ ンバー • ビット.ポジション* ユーザーの コンソールをコントロールす る I/O 
ハードウェアの極性を定義するために， へッダー フ アイルを 構成しなければ 
ならない•もし， BIOS が コンソール 出カ ステータスをテスト するために小さな 
サブルーチンを 一つ以上含んでいさえすれば，それはより簡単だったのかもし 
れない.しかし人生というのはときにきびしいものである. 

私がこれが CP / M コンソール I / O インターフェイスのあいまいなふるまい 
のいくつかを正しく理解するのに役立つことを望んでいる. getchar , putchar 
などのライブラリ•バージョンがどんな 具合で あるかということに関する 実情 
を知るために，実際に実行させたり DEFF 2 A . CSM の中のソースをみなさい • 
そして，もしコンソールを用いて何かしたかったり，この文書をみてもどんな 
ものかをはかり知ることのできなかったりしたなら，私はいつでも御相談に応 
じます（少なくとも私が電話のすぐ近くにいるときは）. 

G .4 CIO 関数ライブラリ 

CIO と名付けられた新しいユーティリティー • パッケージ （ CIO . CSM ソー 
ス • フォームの中に含まれている）は，トータルな直接コンソール I / O コント 
ロールを要求するアプリケーションの中で使用するためのものである. 
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付録 H 


浮動小数点•関数パッケージ 


ボブ • マシアス 


H .1 はじめに 

浮動小数点のパッケージの構成は： 

1) FLOAT . C : C で書かれた関数 

2) FP ••ワーク•ホース機能 （ DEFF 2. CRL の中） 

3) FLOATSUM . C : サンプル•プログラム 

ここにあげるのは，どのようにして動作するかということである.使用した 
いと思うすべての浮動小数点数のためには，ユーザーは5つのエレメントを持 
つ文字配列を宣言しなければならない.それから，関数 コールの 中でそれを指 
定する必要のあるときは，いつでも配列のポインタをパスしなさい.ボブの関 
数はその引数がそういった文字配列に対するポインタであるように思ってい 
る. 

4つの基本演算機能は: fpadd ， fpsub , fpmul , fpdiv でこれらは各々3つの引 
数を取る.それらは，その結果が出るような5文字の配列に対するポインタと 
2つの演算子（浮動小数点のオペランドを表わしている5文字の配列に対する 
ボインタ） 

結果は悪影背を持たない引数のいずれかに置かれる. 




たとえば，操作： 
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fpmult ( foo , foo , f 〇〇);は， f 〇〇と f 〇〇を乗算し，結果を foo の中に置く. 

ユーザーが要求している値に対して，浮動小数点の文字配列を初期化し，人 
間の読めるフォームの中でその値をプリント•アウトするために，次の関数が 
含まれている. 

— ftoa は，浮動小数点の値を ASCII の文字列（ユーザーが" puts ” を用いて 

プリント•アウトできる）へ変換する. 

注：この関数の明白な使用は FLOAT . C の中で特別にカスタマイズ 
された printf ファシリティーを使用するときは必要でない. 

一 atof は， ASCII の文字列 （ NULL で終結された）を浮動小数点の値に変 
換する. 

一 itof は，核数を浮動小数点の値に変換する. 


H .2 詳しい閧数要約 

次の関数は ， BDS C のユーザーが実数をアクセスし，操作できるようにする 
ためのものである.各々の実数は，5バイトの文字配列に割り当てられる （char 
fpno [5]). 最初の4バイトは， LSB から始まる仮数部で5番目のバイトは指数 
である. 

ipcomp ( opl , op 2) 

char opl [5] , op 2 [5]; は次の値を戻す. 


もし opl > op 2 ならば 1 

もし opl く op 2 ならば一1 

もし opl = op 2 ならば 0 


ほとんどの浮動小数点パツケージに関していえば，浮動小数点数を取り扱う 
ときは同等性を比較するのはよいことではない. 
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char * fpadd ( result , opl , op 2) 
char result [5] , opl [5] , op 2 [5]; 

は， opl + op 2 の結果を result に記憶する • opl と op 2 は浮動小数点の値でなけ 
ればならない. result の先頭のポインタを戻す. 

char * fpsub ( result , opl , op 2) 
char result [5] , opl [5] , op 2 [5]; 

は， opl — op 2 の結果を result に記惊する • opl と op 2 は浮動小数点の値でなけ 
ればならない.そして result の先頭のボインタを戻す. 

char * fpmult ( result , opl , op 2) 
char result [5] ， opl [5] , op 2 [5]; 

は， opl * op 2 の結果を result に記憶する • opl と op 2 は浮動小数点の値でな 
ければならない.そして result の先頭のポインタを戻す. 


char * fpdiv ( result , opl , op 2) 
char result [5] , opl [5 J , op 2 [5]; 

は， opl / op 2 の結果を result に記憶する • opl と op 2 は浮動小数点の値でなけ 
ればならない•ゼロによる割り兑の結果は0である. result の先頭のポインタを 
戻す. 

char * atof ( opl , si ) 
char opl [5] , * si ; 


は， ASCII の文字列 si を浮動小数点の値へ変換する.そして， opl の中にその 
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結果を記憶する.この関数は先行するホワイト • スペースは無視される力す，値 
の中にホワイト•スペースを含むことはできない.次のものは正しい例である. 

”2”，” 2202222222283.333 ”，” 2.71828 e -9 ”，” 334, 3333 E 32 ” • ” 3443. 
33 E 10” は，不当である.なぜならば， スペースが 含まれているからである. 
指数の値は： 一38から+38の範 M 内でなければならない. opl の先頭ポインタ 
が戻される. 

char * ftoa ( si , opl ) 
char ゃ si , opl [5]; 

は，浮動小数点の値 opl を ASCII の文字列に変換し， si から記惊する. 7桁の 
梢度を持つ具体的な表記法で書式化される.その文字列は NULL によって終 
結する.そして， si の先頭ポインタを戻す. 

char * itof ( opl , n ) 
char opl [ d 」； 
int n ; 

浮動小数点の値 opl を整数 n の値へセットする. n は符号付き整数であると 
想定される. 

H .3 一般的な注意 

浮動小数点操作は，単純な式ではなく関数 コールと して考えなければならな 
い.浮動小数点パッケージの能力によって，コンパイラの能力を混乱させない 
ために，特別な注意を払わなければならない.浮動小数点の値に初期値を与え 
るためには，たとえば次のような命令文を使用することはできない. 


char fpno [5] 
fpno = " 2.236 ，，； 
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そのかわりに 

char fpno [5] 、 

atof ( fpno , " 2.236 ”）； 

と命令しなければならない.さらに，” ival ” と呼ばれる整数変数の値へ浮動小 
数点の値をセットしたい場合は， 

char ipno [5] ; 
int ival ; 


fpno = ival ; 

とやっても動作しない.最後の行を 

itof ( fpno , ival ) ;に変えなければならない. 

もっと例をあげてみよう. 

次のものは，100.2と 一 7. 99を加えた結果を5文字の配列 a に記憶する. 

fpadd ( a , atof ( b , ” 100 .2 ，， ）， atof ( c , ” 一 7.99 ，， ）)； 

( b と c も 5 文字の配列でなければならない.） 

次のものは， a に1を加えない.なぜならば， opl と op 2 は浮動小数点の値(実 
際は文字に対するポインタ）でなければならない. 

fpadd ( a , a ,1); / * bad use of ” fpadd " * / 

上記の関数は，全部 C で書かれているが，それらのほとん‘どは本当にいやな 
作業を全部行うために， fp と呼ばれる 単一のワークホース 関数を コールす る. 
この間数は， DEFF 2. CRL に含まれている.これは，そのハ。ツ ケージの マシ ー 
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ン*コード化された部分である. fP 関数のためのソース • コードは BDS C の 
ユーザーズ•グループから手に入れる.あるいは ， SASD ( Self - Addressed , 
stamped 8 ” DISK : マスターデイスケットのこと）を BD ソフトウェアに送りな 
さい. 



付録 I 


BDS C のための倍精度整数パッケージ 


ロブ*シヨスタック 

1982年8月 


1.1 はじめに 

このパッケージは，ボブ. マシアス 氏の浮動小数点パッケージと同じような 
粘神で BDS C に倍精度 （32 ビット）符号付き整数の能力をつけ加える.加滅乗 
除と modulus のルーチンや比較，割り当てなどいろいろな機能が含まれてい 
る. 

倍稍度整数は，4つの文字の配列に記惊される.倍精度整数父は， 
char x [4] :と宣言される. 

内部の表現は，2つの補数フォームになり，配列の第1バイトが符号 （ MSB ) 
である.しかし，ほとんどの目的では内部表現にたずさわる必要はない. 

倍精度整数を操作するルーチンのほとんどは，3つの引数を必要とする.最 
初の引数は結果が記憶されることになる場所のポインタで，他の二つはオペラ 
ンドである.たとえば，次の倍精度整数 X ， y , z (全部 char [4] として宣言 
される）を用いた. 


ladd ( z , x , y ) 



\m I BDS c のための倍数 w 度核数パッケージ 


185 


は， X と y の 合計を計算し， Z へそれを記憶する.これはその コールの 値とし 
て戻される.その結果の引数はオペランドの引数のうちの1つ（あるいはその 
呢方）と同じものであってもよい（たとえば， ladd(x, x, x) は”正しいこと’’ 
を行う）. 

パッケージは，ある部分は C で，そしてある部分は（手っ取り早くつめこむ 
ため） 8080 アセンブリ言語で書かれている.それを利用するには，単に LONG. 
CRL を ユーザーの プログラムにリ ンク すればよい.各 ルーチンに ついての記述 
は下にあげられている. 

itol (l,i) 
char 1 [4] ; 
int i; 

は， 16 ビットの整数 i を倍精度整数の値として 1 へ記惊させる.そして1を戻 


atol(1,s) 
char 1 [4] ; 
char ^ s; 

は， Ascii の文字列 s を倍精度整数 1 へ記憶させ， 1 を戻す. s の一般的なフォ 
ームは十進数字の文字列でマイナス•サイン（なくてもよい）によって先行さ 
れ，数字以外のもので終結する. 

Itoa (s,1) 
char ^ s; 
char 1 [4] ; 

倍精度整数の値 1 を Ascii の文字列にし， s に記憶しそして s を戻す • 1 が負 
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の数である場合，マイナス•サインが先行する. Ascii 数字は， NULL で終結さ 
れる. s はその変換をうけ入れるのに十分な大きさでなければならない. 

ladd ( r , opl , op 2) 
char r [4]; 

は，倍稍度整数 opl と op 2 の合計を r の中に記憶させ， r を戻す. opl と op 2 は 
r に使用することができる. 

lsub ( r , opl , op 2) 
char r [4]; 

char opl [4] , op 2 [4]; . 

は， ladd と同様であるが， opl - op 2 を計算する. 

lmul ( r , opl , op 2) 
char r [4]; 

char opl [4] ， op 2 [4]; 

は， ladd と同様であるが， opl * op 2 を計算する. 

ldiv ( r , opl , op 2) 
char r [4]; 

char opl [4] , op 2 [4]; 

は， ladd と同様であるが，倍精度整数の商 0 pl / 0 p 2 を計算する. op 2 がゼロな 
ら結果もゼ'口となる. 


lmod ( r , opl , op 2) 
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は， ladd と同様であるが ， opl mod op 2 を計算する • op 2 がゼロなら結果も 
ゼロとなる. 

lcomp ( opl , op 2) 
char opl [4] , op 2 [4」； 

倍梢度整数 opl と op 2 を比較して， 1， 0, 一 1 のうちの一つ（ふつうの整数) 
を戻す.戻す値はそれぞれ （ opl > op 2 )，(opl = = op 2 )，(opl < op 2) の比較に 
対応する. 

lassign ( dest , source ) 
char source [4] , dest [4]; 

は，倍粘度核数 source を倍精度整数 dest へ割り当て dest に対するボインタを 

戻す. 


ltou (1) 
charl [4] ; 

は，倍精度整数1を符号なしの整数に変換する.（切り捨てによって） 

utol (1， U ) 
char 1 [4] : 
unsigned u ; 

は，符号なしの整数を倍精度整数の値に変換し，1に記憶させ，1を戻す. 
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I .2 内部動作 

上記のルーチンの中の作業のほとんどは， long と呼ばれる単一8080アセンブ 
リ言語の関数によって，つまり，ファイル LONG . CSM (ユーザーズ•グルー 
プから手に入る）の中に含まれるソースによってなされる.そのパッケージの 
残りは LONG . C の中にある•プリミティブのほとんどは，単に long をコール 
し，それにファンクシヨンコード（どんな操作が行なわれるのかを教える）を 
操作される引数と共にパスする. 

フアイル LONG . CRL は， LONG . C の中で与えられたコンパイル済みの_ 
数を含んでおり， DEFF 2. CRL はワークホース_数 lone を含んでいる. 
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付録 J 

TELEDIT 遠隔通信プログラムおよびミニスクリーンエディタ V 1.1 


ニゲル•ハリソン 


” teledit ”はオリジナル BDS Telnet プログラム，ワード•クリステインソ 
ンの MODEM プログラム，その MODEM 7 系のもの， XMODEM と呼ばれる 
C バージヨンおよびニゲルのミニスタリーンエディーをつなぐものである•実 
際，このプログラムは細かく分けられるまで，しばらくは CDC 110 マイクロシ 
ステム上の基本エディタとして使われていた.このプログラムは，最終的に必 
要なモデムプログラムではないかもしれないが，他のどんなものよりも多くの 
ルートをもつている.” TELEDIT ’，力す ， BDS C のディスクに含まれていなけ 
れば ， BDS C ユーザーズ グループから手に入れることができる • 

Teledit は，通信プログラムでフアイルを送ったり，他のシステムとつないだ 
り， ASCII ターミナルのネットワークとして使うことができる.また，リモー 
トシステムで，テキストを入れている間に，ラインを操作することができる簡 
単な エディ タがついている.フアイル転送モードでは2進でもテキストフアイ 
ルの状態でも受信送信が可能である.メニューからのモード選択は以下の通り 
である. 
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T :ターミナルモード……テキストは集積しない. 

Teledit は ASCII ターミナルのように動く. 8ビットキャラクタ 
で受信送信される.ハ。リティビットのチェック，挿入または移動 
はされない. SPECIAL キャラクタをタイプすることで，選択メニ 
ューにもどることができる. 

SPECIAL キヤラクタは，コントロールシフトのアプアロー （ T ) 
に設定してあり，誤って打ってしまうことのないようにしている. 
もし， SPECIAL キャラクタを変更したければ，# define SPE - 
CIAL …で Teledit を再コンパイルすればよい. 

X :ターミナルモードーテキスト集積をする. 

モードは上と同様であるが，どんなキャラクタでも，通信リンク 
に受信されたものはテキストバッファにセーブされる.タブ，改 
行，書式送りのキャラクタもバッファ内に配厲される.他のキャ 
ラクタは捨てられる.ターミナルモード中にエディタを呼ぶとき 
は コント ロールキーを押したまま，” E ’’ をタイプすればよい. 

X モードは集積されたテキストに使われたファイル名を即座に出 
す. 500行のテキストが入れられたあとで，テキストパ、ッファにセ 
ーブされ，余分なラインが入ると，コンソールがアラーム音を出 
す.この状態になったとき，ユーザーは都合のよいところで，リ 
モートステーションの通信を一時中止，下記にあるように，集め 
られたテキストをディスク上にセーブする. 

G : トグル エコーモー ド （エコー のセット） 

もし，ユーザーが，全ニモードで通信中リモートステーションか 
らエコーを受信しているときが，半二重モードにあるときはトグ 
ルを入れるべきではない.このオプションを使って Teledit を走 
らせている他の人と話をするには，ファイルを送って，次に送ら 
れるファイルを持つ人に知らせる. 
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E :エディトテキスト集 

メニュー ディスプレイから，エディタに入る.これは，テキスト 
集が入れられて，テキスト集ファイルがオープンされた状態で， 

X :ターミナルモードになるまで操作できない.エディタコマン 
ドは，次に延べるとおりである. 

F :テキスト集を バッファからファイルに セーブする. 

テキスト集稂モードで，パ、ッファに集められたテキストをセーブ 
する.ファイルをクローズしてはいけない • 

U : CP/M ューザ エリァの選択 

これは ューザエリ ァを持つ ューザの ためのもので，持っていなけ 
れば無視してよい. 

V : CP/M ロジカル ドライブ 

使用可能なディスクドライブを選ぶ.選んだドライブは現在つな 
がれて いる ディスタとなる. 

D :税在使用しているドライブとユーザ領域のディレクトリのプリント 

現在のところのディレクトリは， U または V コマンドにより選ぶ 
ことができる. 

S : フアイル送信， MODEM プロトコル 

送りたいファイル名を打ち受信者からの " synch up ” を待つ. 
受信者が，この teledit と同じ MODEM プロトコルを使うプログ 
ラムを使用していなければならない. 

操作終了後，メニューにもどる. 
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R :フアイ ル 受信 ， MODEM プロトコル 

受信したいファイル名を打ち，送信者から送信されてくるのを待 
つ. 送信者は Teledit か同じ MODEM プロトコルを使ったプロ 
グラムを使用していなければならない. 


Q :終了 

作業を止めて コマンド レベルにもどる.もし ，X モードで テキス 
トファイルが集められていれば，セーブしたいかどうかを聞いて 
くる. 

SPECIAL 

SPECIAL キャラクタを通信ラインに必要であるかぎり送る. 
SPECIAL キヤラクタは TELED . C ソースファイルの先頭で 
# difine ステートメントによりコンパイル時に定義される. 

スクリーンエディタ 

エディタは，このモードに入ったときに"*”を返してくる.現在の 

行の場所はプロンプトのすぐ下であることがある.エディタコマンドは 

下記のとおりである. 

A ( append ) ファイルに付けたす.現在の行の前に挿入 

することができる. 

B ファイルの始まりにもどって，そのページを画面上に 

出す.現在の行がテキストファイルの最初の行にな 
る. 

F " F ” のあとにつけられたパターンを含む行を搜し出 

す.見つかれば，その行が現在の行になる.前の方に 
向かって捜して行き1回りする. 

I 挿入モードに入る.このモードをぬけるには，コント 

ロール Z を 打ち リターンキーを打つ •挿入 モー ドから 
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K 

nK 

L く pattern 〉 


0 


P 

一 P 


ぬけるときは，行の先頭に入ったときでなくてはなら 
ない.そうでなければ Z は無視される. 

現在の行を消す. 
n 行消す. n は1〇進数. 

” L ” のあとにあるパターンが行の先頭にある行を搜 
す- 

くコント ロール〉 Z が打たれるまでテキストの行上に 
書くことができる.くコントロール〉 Z は，新しい行の 
始めに打たれなければいけない. 

テキストの次のページに行く. 

テキストの前のページに行く. 


Q 

Sn 


Z 


n < cr > 

く cr > 

一 n く cr > 

スペースパ、一 
# 


エディタ終了 

スクリーンサイズを n 行にセットする.何もしなけれ 
ば24行デイスプレイに22が定めてある .25 行コンソー 
ルであれば S 23 を使い，コントロールデータ110のと 
きは S 28 を使う. 

ファイルの Zee ( end ) 終りに行く.最終行のページを 
見たいときなど，これで終りに行き 一 P で見ることが 
できる. 

ファイル上での n 行前に進む. 

ファイル上で1行前に進む. 

ファイル上で n 行後ろにもどる. 

ファイル上で1行後ろにもどる. 

ファイル中のテキスト行の数をプリントする. 


移植 


Teledit は，下記に延べるような移植者の特別な S 3 境に合わせたコン 
スタントの BDS C でコンパイルしなければならない. 




#difin HC 


” S * ” /* s はユーザのコンソールスクリーンに 
カーソルをも どす為に必要な ストリン ダ*/ 

# difin CLEARS ” S ’’ / * s はユーザのコンソール上のスクリーンを 

クリアする為に必要なストリンダ*/ 

BDSCIO . H と HARDWARE . H へッダーファイルは TELED がコンパイ 
ルされる前に，ターゲットコンピュータ機器構成に適切に編成されなければな 
らない. 

不必要な エデイ タ コマン ドは， ソース コードの エディ タファンクションから 
一致したステートメントを取り去り， Teledit を再コンパイルすることにより 
町能である. 
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付録 K 

CDB:BDS C デバッガ 

version 1.2 
4 November 1982 


David Kirkland 
5915 Yale Station 
New Haven , Connecticut 06520 
(203)787 — 9764 

Copyright ( c )1982 by David Kirkland 


注記：この付録は ， BDS C または ， BDS C ユーザーズ•グループから 
供給される CDB デバ'ツキング•パツケージの解説書の一部分であ 
る . BDS C のデイスケツトの中に，これが含まれていないならば， 
本解説書は， CDB パッケージを購入するか否かを決定するのに十 
分な内容である. 


K.1 はじめに——構成について 

CDB は ，， BDS C コンパイラで書かれた，対話型のシンボリック • デバッガ 
である. CDB は，プログラムに対して，ブレークポイントを設定する，トレー 
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スを行う，シンボリックな表示や，変数値の設定を可能にする. 

これは，アプリケーション•プログラムの開発者が，プログラムの開発環境 
で使用するものとして，供給される. 

デバッキング • パッケージは，3つの実行可能なファイルから成り立ってい 
る. Ai •初のものは， L 2. COM である.これは，オブジェクト•コードを生成す 
るための CRL ファイルのリンカーであり ， BDS C 標準の CLINK リンカーの 
代替版である.本パッケージに含まれる L 2 リンカーは ， Mark of the Unicon 
社の Scott Layson 氏によって書かれた L 2 リンカーを，多少修正したものであ 
る.この新しい L 2 リンカーは，新しいデバッキング機能とともに， Layson 氏 
の L 2 のすベての機能と，多少のバグを取り除いたものである. L 2 は，デバ'ッ 
キング•ハ。ッケージの他の部分で使用するための COM ファイルや，シンボル. 
テーブルを生成する. 

2番目のものは，プログラム開発者（本解説書では，”ユーザー”と称して 
いる）が，デバッグを行うためのプログラム， CDB . COM である， CDB は，ユ 
ー ザーが投入したコマンド行の引数を解析し，メモリー内のさまざまな，デー 
夕•テーブルを準備し，本パッケージの3番 H のプログラムである. CDB 2. 0 VL 
を起動する. CDB 2 は， CP / M の BD 0 S の直前のメモリーに常駐し，デバッグ 
するプログラム （" ターゲット•プログラム”）を， TPA (" Transient Program 
Area ” の略.通常，16進で0100のアドレスから始まる）からロードする.つま 
り， CDB 2 は，ターゲット•プログラムといっしよに，メモリー内に常駐する. 
CDB 2 がターゲット•プログラムをロードすると，実行を開始するために，ター 
ゲットのメインルーチンへ処理を移す.ターゲット.プログラム内の⑴関数に 
入るとき， （2) 関数から戻るとき， （3) コンパイルされた C の命令文の鍅初のコー 
ドを処理するときに，処理は， CDB 2 に移り，ターゲット•プログラムを続行し 
たり，中断したり，中断して デバ、 ッガのコマンドに移ったりする（先に述べた 
ように，列挙された出来事によって，いちいち CDB 2 が呼び出されるわけでは 
ない）. 


本解説書では，角かっこ [] で圓まれたものは，オプションであると解釈 
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される.したがって，その部分は省略可能である. 

K .2 デバッガの作成 

デバッガのいくつかのモジュールに対して，さまざまな変更が行なわれる可 
能性があるので，パッケージは，ソース•コードで供給する.この セクション 
では，ソース•コードを，3つの実行可能な ファイル， L 2. COM , CDB.COM 
そして CDB 2.0 VL に変換するための手順について解説する. 

L 2 の作成 

L 2 は，カスタマイズの必要性がないので，ユーザーが，自分自身のバージョ 
ンを作成する必要はない.供給される L 2 は，現在ログされているドライブから 
C . CCC と DEFF *. CRL を取り込む.これを変史するには， L 2. C 内の説明に 
従って，# define DEF - DRIVE のマクロの宣言を変吏する.もし， L 2 を変更（ま 
たは，バグ取り）するならば， CDB パッケージに含まれている Scott W . Layson 
氏による” The Mark of the Unicorn Linker for BDS C ’’ の解説 If に従って， 
L 2. COM を作成する.しかし，これらの変更を行うときに，次のことに注意す 
る必要がある •（1) 使用する必要のある ファイル， SCOTT . C がない. （2) 他のバ 
ージョンの L 2 を用いて， L 2 の テ、、 ッガ•バージョンを作成するときは， CC に 
対して， "_ e 4800 ” を指定しなければならない.また， CLINK を用いて， L 2 を 
リンクするときは， "- e 4 c 00” を指定しなければならない.その手順は，次の 
ようになる. 

CC 12 .C - e 4 c 00 [または， - e 480 0] 

(X chario.c 

clink 12 chario [または， 1212 chario ] 

CDB 2 を記镱する場所 

CDB . COM や CDB 2.0 VL を作成する前に，まず， CDB 2.0 VL を，メモリ 

一のどこかに配置するかを決める必要がある. CDB 2 は，ターゲット•プログラ 
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ムと，それが使用するスタック•ポインタより上に，また， CP / M の BDOS と 
CDB 2 自身のスタック•ポインタより下のメモリーに配諝する. CDB 2 は， 
0 x 4600 (18 k ) より少し少ない大きさで，外部領域は約 0 x 0980 バイトである. 
それから， CDB 2 のスタック （ BD 08 の直前から始まる）の大きさを，約 ox 0480 
バイトに設定した.この値は，変数の値やシンボルの表示で（再帰的に）使用 
される複雑な式を，計算するのに十分な大きさであると思う. 0 x 5400 になるの 
で， CDB 2 の開始アドレスは， BDOS の開始アドレスより， 0 x 5400 だけ手前に 
なる.私のシステムでは， BDOS の開始アドレスが 0 xE 406 なので， CDB 2 の開 
始アドレスは， 0 x 9000 になる（これは，これから述べる例の値として利用する）. 

(もし，あなたのシステムの BDOS の開始アドレスが，わからないなら ， DDT 
を用いて，アドレス0005のジャンプ命令を調べることによって知ることができ 
る.まず DDT を起動する. DDT は，"一”のプロンプトを表示するので， 

” L 5 ” とタイプする. DDT が表示したリストの最初の行が， BDOS の開始アド 
レスであり，それは，最後が” 06”で終っている.） 

供給されるディスケットに含まれる CDB . COM と CDB 2.0 VL は， D 300 以 
上の間始アドレスを持つ BDOS のシステムで動作する. 60 K バイト以上の 
RAM を持つほとんどのシステムで，このプログラムを使用することが可能で 
あるが，ターゲット.プログラムとシンボル.テーブルの領域として 31 K バイ 
卜しか削り当てられない.もし BDOS が D 300 以上の開始アドレスを持ち，夕 
ーゲット•プログラムの領域をもっと必要とするならば，あるいは， BDOS が 
D 300 以下のシステムならば，正しく動作するデバッガを作成しなければならな 

い • 

CDB 2 を配; S するアドレスが決定したならば， CDB . H ファイルの # define 
CDB 2 ADDR の宣言を，決定した値に変史する.ついでに ，# define CDB 2 
_ DRIVE の宣言も变史するとよい.これは， CDB に対して 一 d オプションを 
指定しないときに， CDB 2. OVL ファイルを，どのドライブからロードするかを 
指定するものである.ここには， " A ” のようなドライブ名（コロンを付けず 
に）か，あるいは，”〇 / A ” のように，ユーザー領域の指定子とドライブ名を含 
んだものを指定することができる.デフォルトでは，ドライブ名は指定されて 
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いないので， CDB2 は，現在ログされているドライブのユーザー領域のディレク 
トリからロードされる. 

CDB の作成 

CDB. H ファイル内の CDB2ADDR の変更が済んだら， CDB の 2 つのモジ 

ユールを 次のように コ ンパイルする. 

cc cdb.c - e 3200 
cc build.c -e 3200 
12 cdb build 


CDB. SUB サブミット • ファイルは， 上記の処理を一括して実行してくれる. 

CDB 2 の作成 

CDB2 を コンハ。 イルするには， CDB2 の外部領域のアドレスを知る必要があ 
る.外部領域は， CDB2 のコードのすぐ後のアドレスから始まるので， 
CDB2ADDR の値に 0x4600 (K.2 の" CDB2 を記惊する 場所，， で述べられてい 
るコードの長さ）を加えた値を川いる.私のシステムでは， 0xd600 になるので, 
CDB2 を コンパイ ルするときに， コンパイ ラに対して” -e d600 ” を指定する. 

CDB2 は， 7 つのソー スフ アイルから成り立っている.それらを コンパイルす 
るときには，次のように入力する. 

cc cdb2.c -exxxx 
cc atbreak.c -exxxx 
cc break.c -exxxx 
cc command.c -exxxx 
cc print.c -exxxx 
cc parse.c -exxxx 
cc util.c -exxxx 
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xxxx は，外部領域のアドレスである （ D 600 のように）.また， CDB 2 .SUB 
サブミット.ファイルを用いると，次のように入力するだけでよい • 


submit cdb 2 xxxx 


xxxx は，外部領域のァドレスである.また，次の入力 
submit cdb 2 xxxx d : 

では，デフォルトのドライブにソース•ファイルがないとき，ドライブ d から 
ソース.ファイルを取り込むことを指示する. 

すべての C ファイルをコンパイルしたら，次は，アセンブラのソース•ファ 
イル， DASM . CSM をアセンブルする.これは， CASM フォーマットで記述さ 
れているので， CASM プリプロセッサを使用してからアセンブルする.次のよ 
うに命令を入力する. 


casm dasm 
asm dasm 
ddt dasm.hex 
gO 

save 3 dasm.crl 


コ ンパイルされた CASM を持っていない ユーザーの ために， DASM.CRL 
ファイルを供給されるデイスケットに記録してある • 

Ai 後に作成するファイルは， NULL . SYM と呼ばれる空のファイルである. 
CDB 2.0 VL は，オーバーレイ•セグメントとして作成されるので， L 2 は，ル 
一卜.セグメントで定義された関数のシンボル • テーブルを読む必要がある • 
なぜならば，ルート•セグメントも，関数も存在しないのだが， L 2 に対して， 
•ovl オプションを指定すると，ルートネームを必要とするので，次の命令 


save 0 null.sym 
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を実行することによって，リンカーに対して，空の（つまり，ダミーの）ファ 
イルを指定する. 

さて，これで，すべての CRL ファイルが用意できたので，リンクを行なうた 
めに，次の命令を入力する. 

12 cdb 2 dasm atbreak command break print parse util 
-ovl null yyyy -wa 

ここで， yyyy は， CDB2ADDR の値を 16 進で指定する. LCDB2.SUB サブミ 
ット.ファイルは，これらの処理を，一括して行ってくれる. 

デバ、 ッガを使う準備は整った！ 

RST ベクタを変更する 

供給される デバッガは，ブレーク ポイントを生成するために， " RST 6” 8080 
命令を使用する. RST 6 命令に出会うと，処理（厳密にはプログラム•カウンタ） 
は， アドレス 0 x 0030 へと 移る.あるシステムでは，このメモリーエリア（また 
は RST 6 命令自身）を他の処理に割り当てているものがある.もしそのような 
場合は， ブレーク ボイント機能で用いる RST ベクタを他の値に変更する必要 
がある . RST のべ クタは，1 から 7まである. RST 0 は 使用できない. RST の 
ベクタを変更するには， L 2. C , CDB . H と， DASM . CSM を変更しなければな 
らない . 

L 2. C と CDB . H は ，# define RST - NUM の値を，適切な値に変更し， DASM . 
CSM は， RstNumEQU の値を，同じ値に変吏する.値は，1から7までの範 
_で指定すること. 

最後に，ターゲット•プログラムを（一 k オプションを用いて） コンハ。 イル 
するときに，新しい RST ベクタの番号を指定する必要がある .一 k オプション 
のかわりに- kn と指定する.ここで n は新しい RST ベクタの番号である. 
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K .3 デバッガの起動方法 

デバッガを使用するには，まず，ターゲット•プログラムをコンパイルし， 
リンクしなければならない.それから，デバッガを起動する.このセクション 
では，その方法について解説する. 

コンパイル： CC の一 k オプション 

BDS C ユーザーズ •ガイドに 述べ られていよにうに，一 k オプシ ョンは， コ 
ンパイラに対して， （ l ) CDB という拡張名を持ったシンボル•テーブルを生成す 
る •（2) コンパイルされたコードの中に， RST の命令を挿入する，を指定する. 
ユーザ—は， CC に対して，他のコンパイルと同様のコマンドと，一 k オプ ショ 
ンを付加したものを発行する.例えば， 

cc target.c 一 k 


リンク： L 2 の- D ，- S と- NS オプション 

ターゲット•プログラムをリンクす るには ， CLINK のか わりに， L 2 リンカ 
一を使用す る こと • L 2 の 解説書で述べられて いるよ うに， L 2 は， CLINK とは, 
異なる コマンド•シンタックス であり， デバ、 ッガ•バージョンの L 2 は，次の よ 
うな，新しく追加され たオプションを 含んで いる. 

一 D CDB と互換性のある モジュールを 生成し，出力する.この オプションは， 
重要な関数の先頭に， RST 命令を挿入す る •一 s や- ns オプションが，同 
時に指定されない限り ， DEFF *. CRL の関数が ， DEFF *. CRL の関数を 
参照するもの以外の関数の先頭に， RST 命令を挿入する. 

-S - s の 後に指定される CRL ファイルは， "システム，， ライブラリとし 
て，取り扱われる. システム •ライブラリ関数によって参照される システ 
ム•ライブラリ関数は， L 2 によって RST 命令を挿入しないし， デバッガ 
によってトレースされることもない .一 s と- ns オプ ショ ンを指定せず 
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に，一 d オプションを指定すると， "一 S diff diff 2 diff 3 ” と指定したのと 
同じものになる. 

一 NS システム•ライブラリ • ファイルを持たないことを指定する•このオプシ 
ヨンは ， DEFF *. CRL がシステム•ライブラリであるという，デフオルト 
解釈を無効にするために用いる. 

CDB の起動 

デバッガを起動するには，次の書式でコマンドを入力する. 


cdb target —name [一1 [ local — cdbs ] [― g [global — cdbs ]] 
[一 d [ user /] drive 」[% [target operands 」] 


一 I と 一 g オプションは，ターゲット*プログラムで使用される変数などの 
怡報を含んだシンボルファイル . CDB を読み込む•一丨 一 g を指定しないとき 
は，デフオルトとして target - name . CDB が使われる • ターゲットのソース • 
コードが，2つ以上のファイルから成り立っているときに，これらのファイル 
のシンボルの定義を利用したければ，それぞれのソース•ファイルの CDB ファ 
イルを CDB に介して与える必要がある•それぞれのソースファイルが，全ての 
グローバルを宣言するヘッダーファイル （ H ) を包含しているならば，一 I オプ 
ションをぬ用するのみで，一 S オプションを指定する必要はない.これらのオプ 
ションで指定するファイルネームのかわりに0を指定すると CDB は（ローカ 
ルか，グローバルの〉，シンボル•ファイルを読み込まない.これらのオプシヨ 
ンを，引数を付けないで指定すると， CDB はシンボル•ファイルの入力を要求 
するプロンプトを表示し，ユーザーがシンボル•ファイルのファイルネームを 
入力するのを待つ.空の行（単に CR ) は，入カプロンプトを打ち切る. 

オペランドは，ターゲット•プログラムの引数を指定するものである. 

” 以後に表われるオペランドは，ターゲット•プログラムの引数として扱 

われる.の後に，オペランドが何もない場合，引数の入力を要求してく 
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る （ CDB は，"％”の後に与えられた引数を， " argv ” に渡さずに，例えば， 
0 x 0080 からのメモリーに書き込む.そして，ターゲット•プログラムの中の C . 
CCC が，それを解析する）. 

一 d オプションは， CDB 2. OVL をロードするドライブ(ユーザー領域も指定 
可）を指定する.供給されるパッケージのデフオルトは， CP / M のデフオルト • 
ドライブからロードするが，これは，変更することができる. 

標準的な CDB の起動は，次のようなものである. 

cdb target 

要約 

標準的な，デソぐッガの手順は，例えば， target . c というプログラムを用いて， 
次のように行なう. 

cc target.c 一 k 
12 target 一 d 
cdb target 

さらに複雑な例をあげると， FOO.C という” main” 関数と，いくつかの関数 
が含まれるている ソース •プログラムと，それが必要とする関数が含まれるて 
いる BAR. C と LIB. C がある. FOO.C は，同じグローバル変数をもっている 
(GLOBAL. H というヘッダーファイルが# include によって包含される）. 
LIB. C は，グローバル変数を使用しないライブラリ関数の集まりである.最後 
に， STBLIB. CRL ファイルという （デバ、 ッグされた）ファイルを使用すると想 
定する.これをコンパイルするには，次のコマンドを入力する. 

cc ioo.c —k 
cc bar.c — k 



cc lib.c 一 k 


\mK CDB : BDSC デバッガ 


205 


次に，リンカーを用いて，これらのプログラムをリンクし， FOO . COM を作 
成する. 

12 foo bar —1 lib —s stdlib 

一 s オペランドは， L 2 に文、 t して， STDLIB . CRL ファイルに含まれる関数を 
トレースしないように， F 00. C 0 M を生成することを指示する.デバッガを起 
勋するには，次のように入力する. 

cdD foo —1 bar lib 

一 I オペランドは， CDB に対して， CC によって作成された BAR . CDB と 
LIB . CDB のシンボル.ファイルに含まれるすべてのローカルなシンボルを口 
ードするように指示する. FOO . CDB に含まれる口ーカルおよびグロ ーノぐルの 
シンボルは，すべてロードされる. 

K .4 デバッキング•コマンド：デバッガの使いかた 

このセクシヨンでは，機能別にまとめた CDB の コマンド について解説する. 
デバッガが起動すると， CDB 2 の配3?ァドレス （ CDB 2 ADDR と同じ），ロー 
カルとグローバルのシンボル • テーブルの大きさ，そして，ターゲット.プロ 
グラムのスタック （ CDB 2 のプログラムのすぐ下）の値を表示する.そして，夕 
—ゲット•プログラムに処理を移す.ターゲット•プログラムは， C . CCC 内の 
初期化ルーチンから， " main ” 関数までのコードを実行する.” main ” 関数の 
エントリには，ブレーク•ポイントがセットされているので，処理は，デバッ 
ガの コマンド.レベルへ と戻る • 

ブレーク•ボイント 

CDB は，ターゲット•プログラムに対して，文単位で実行させることができ 
る.ターゲット•プログラムの実行を中断するには，ブレーク•ポイントとキ 
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ー ボードからの割り込みの2 つの 方法がある. ブレーク •ポイントを設定する 
と，ターゲット•プログラムの C の命令文を実行する直前に，実行が中断され 
る.キーボードからの割り込みが発生すると，ターゲット•プログラムの，次 
の C の命令文を実行する前に，実行が中断される.キーボードからの割り込み 
は，単に，キーをタイプするだけで， CDB がこの文字を取り込む時に，実行が 
中断される（しかし，ターゲット•プログラムが，キーの入力を侍っているよ 
うなときは，割り込みは，発生されない）. 

ブレーク •ポイントを設定するには， " break ” コマンドを投入する. 


b [ reak ] [ function - name ] [ statment-number [ count ]] 

角かっこで囲まれた部分は，省略可能である. " break ” コマンドは，単に 
” b ”と入力してもよいし,” br ，，, ” bre ” なども同様に受け付ける.また， 
function-name と statement-number も省略可能である.） function-name を 
省略すると，ブレーク•ポイントは，現在の関数の statement-number で指定 
される命令の文番号に設定される（現在デバッグしている関数の名前は，ター 
ゲット•プログラムを中断した後に表示される.また，それは， " list ” コマン 
ドを利用することによって見ることができる）. statement-number は，指定し 
た関数内の正確なブレーク•ポイントの場所を指定する.命令文は，_数の先 
頭（関数宣言の左かっこが含まれる行）を1とする行番号によって，行単位で 
番号付けされる.次の例ように， 

a = 5 ;putchar (* x ’ ); while (* s ) s + +; 

1 つの行に，複数の命令文が含まれているもののどれかを指定するには，そ 
の行番号 n の最初の命令文は， n . o ， 次は， n . l というようにする.（上の例で， 
行番号が7だとすれば ， ”a = 5;” は， 7.0” putchar ( x );” は 7.1” whil (* s )” 
は7.2，そして，” S++;” は， 7.3 になる .）10 進数が与えられなければ， " 〇 ’， 
と解釈する.文番号は，次のように定義する. 


sn : = line-number [. statment - number - within - line ] 
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(ここで， line-number は，文番号を ， statment - number - within-line は，行 
の中の文番号を表わす.） 

CC は，時として，ソース•コード，またはそこから生成されるコードを，再 
アレンジ することがある.このような場合， ユーザーが 指定する命令文に，ブ 
レーク•ポイントを設定するのは，困難になる. CC がこのような，"特別な命 
令”を生成するのは，次のような場合である. 

(1) コンパイラが，ルーブ命令 （" while ”, ” for ” や” do ”） を処理すると 
きは，ループの最後の部分に，条件分岐命令を生成する. 

(2) ” for ” 命令文の”再初期化式” (” for ” 命令文の3番目の式）はループ 
の敁後の部分におかれる.このように，” for ” 文の後の式は，ループの最 
後の文の文番号の次の値になる. 

話はそれるが，特別な文#号として，0と 一 1がある.文番号0は，関数の 
エントリで，関数のコードが実行される前に位匿する.文番号 一 1は，関数か 
ら戾る場所で，関数から戻った直後に位;??する（そして関数からのリターン値 
を表示する）. 

これまで ， COUNT オペランドについては， 何も触れなかった • ” break ”コ 
マンドで 衍定されるブレーク •ポイン トは ， COUNT で 指定された回数だけ， 
ブレーク •ポイントを 通らない限り，ターゲット. プログラムは 中断されない 
のである. COUNT のデフォルト値は，1であり，したがって，設定されたブ 
レーク •ポイントに 1度でも達すると，ターゲット •プログラムは 中断される. 
COUNT を指定するには，文#号 （ statment - number ) も必ず指定しなければ 
ならない. 

ブレーク •ポ イン トは，1度に40か所まで定義することができる. 

ブレーク •ポイントを，取り除くには， " reset ” コマンドを使用する.文法 
を次に示す. 


r I eset I [ function - name ] [ statement - number ] 


デフオルトは， " break ” コマンドと同じである • ブレーク•ポイントでない 
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地点を指定すると， エラーになる • ” clear ’， コマンドは， 全ての ブレーク •ポ 

イントをリセットするために使用する.文法は，次のとおりである. 


clear 

(" clear ” コマンドは，フルスペルで入力しなければならない.） 

"list breakpoints ” コマン ドは， 設定されているすべての ブレーク • ポイン 
卜を表示す る. 


コードの実行 

コンパイルされ た C のコー ドを実行するための いくつかのコマンドについて 
解説する.” go ’’コマンドは， 単に（前に中断された地点から）実行を開始し， 
ユーザーが，キーボードから割り込みを行うか， ブレーク•ポイント に達する 
まで続けらる • このコマンドのオペランドは，ない. 

ターゲット•プログラムの実行を，モニタしながら行うには， " trace ” コマ 
ンドを用いる.文法は，次のようになる. 

t [ race ] [ number - of - statements ] 

デバッガは， number - of - statements で指定された数の命令文を トレースし， 
命令文を実行する前に，それが含まれる関数名と，文番号を表示する.実行さ 
れ6命令文 力 ? ， number - of - statements に達する前に， ブレーク •ポイント や 

キーボードからの割り込みがあると，実行は，その場所で中断される . number 
- of - statement のデフオルトは，1である. 

” untrace ” （ ” walk ”としても知られる） コマンドは， ” trace ” コマンドに 
類似して いる力す， 命令文を実行する 前に， 関数名と文番号を表示し ない. 文法 
は，次のとおりである. 

u [ ntrace ] [ number - of - statements ] 


” trace ’’ と M じように， number-of-statements で指定される数の命令文を 
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ト レースし，ブレーク •ポイントや，キーボードの割り込みがあると，実行が 
中断される. number-of-statements のデフオルトは， 1 である. 

” run” コマンドは， CDB からターゲット•プログラムへ処理を渡し，デバッ 
ガを離れる.したがって，” run” コマンドを実行した後で，デバッガに処理を 
戻すことはできない.また，” run” コマンドには，省略名はない. 


変数の表示 


” dump’’ コマンドは，メモリーの内容を表示する.コマンドの文法は，次の 
とおりである. 


d [umDi expression [multiple] [format] 


” dump” コマンドは， " p [rint] ”や"，”（カンマ）としても用いること 
ができる（同義語）. 

” dump ” コマンドは ， expression によつて指定されたメモリーの内容を表ボ 
する. expression の全ての定義は，後述するが，最も一般的な使い方として， 
変数名（” i ”や” foo ’’ など）や，数値 (0x0100 や 43000 など）を expression 
に指定するであろう.変数名や，数値が expression に指定されると， CDB は， 
その変数の宣言や数値に適したフォーマットで表示する.もし，変数が構造体 
ならば， CDB は，その構造体に含まれる エレメント も含めて表示する.ユーザ 
一が format を使用するのは， expression に指定する式が，変数や数値ではな 
く，整数のアドレスであるようなときであり， format に指定できるのは，次の 
ものである. 

c 文字 

P ポインタ 

i または w 整数/ワード 

s 文字列 （ NULL で終結される文字配列〉 


format のデフ オルトは ” w ，，である . 
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multiple オプションは，表示するメモリーの大きさを指定する.” dump ” コ 
マンドは，指定された format を multiple で指定した数だけ表示する•例えば， 

dump 0 x 0100 10 c 

は， 0 x 0100 から10文字，つまり OxOlOA までを表示する.また， 


dump 0 x 0100 10 

は， format が指定されないので，デフ オルトの ” w ” と解釈して， 0 x 0100 から 
0 x 0114 (20 バイト）までの内容を，ワードで表示する. 
expression の文法は，次のようになる. 


expression := 

一次式 


* 式 


:=整数 
識別子 
(式） 

一 次式[式] 


一次式 


一次式，識別子 
一次式一〉識別子 


CDB の式は，基本的に， C の式のような論理演算子や算術演算子を，含んで 
いない.式は，次に示すように，かなり複雑になりうる. 

table [table [1, i ] , j ] . name [10] 

" dump ” コマンドの表示を止めたいときは，任意の文字をタイプする. 

C の有効範_の規則は，シンボルの参照のために用いられる.これは，例え 
ば，デバッガが， foo という関数のブレーク•ポイントに達し，中断したときに， 
もし bar という変数が，その関数内で定義されているなら，変数 bar は，その 
_数内のものを表わすことになるが，その関数内で定義されていないときは， 
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グローバル変数” bar ” を参照しようとする.これは，有効範 W の規則によっ 
て， C の関数内で定義される変数は，グローバル変数の名前と同じであっては 
いけない. CDB は，この有効範匪を無視することができる.グローバル変数を 
指定するときは，その変数名の先頭にバック•スラッシュ（”\”，ただし， 
日本の多くのパーソナルコンピュータは，” ¥ ”コードに割り当てられている） 
を付加すればよい.例として， " foo ” 関数から， グローバル 変数" foo ” を指 
定するには，次のように入力する. 


dump \ foo 

" dump ” コマンドは，シンボルの値ではなく，アドレスを指定することもで 
きる•この場合は， expression に指定する式の前に C の”アドレスを求める” 
算術子” &”を付加する.例えば， " table ” という変数のアドレスを求めるに 
は，次のように入力する. 


dump &table 


また，次のような，複雑な式を使用することもできる. 
dump &table [ 1 , j ] 

変数の値の設定 

” set ”コマンドは，メモリーに，データをストアする.コマンドの文法は， 
次のようになる. 

s Let ] expression value [ c ] 

expression によって指定されるアドレスに，値 value を書き込む.値は，通 
常16ビットであるが，次のようなとき， 8ビットとして書き込まれる 

(1) expression が， char 型の変数のとき 

(2) expression が， 1’のように ，引用符で囲まれているとき 

(3) ” c ’’オプションを指定したとき 
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リスト •コマンド： さまざまなインフォメーション 

" list ” コマンドは， 次のようにさまざまな インフォーメーションを， 表示す 
る. 


1 [ ist ] 

1 List ] a [ rguments ] 

1 List ] b [ reakpoints ] 
1[ ist ] g [ lobals ] 

1[ ist ]1[ ocals ] 

1[ ist ] m [ ap ] 

1[ ist」t [ raceback ] 


現在の関数名と文番号を表示する. 

現在の関数の引数を表示する. 

すべての ブレーク •ポイントを表示す る. 
すべての グローバル 変数を表示す る. 
現在の関数内で宣言されている変数を表 
示す る. 

ターゲット•プログラムのリンク•マップ 
を表示する. 

main から現在の関数までのトレースさ 
れた関数を表示する. 


"list globals ” や， "list locals ”による変数の表示を止めるには（キヤリ 
ッジ•リターン以外の），任意のキーをタイプする.大きな fid 列の表示をスキッ 
プしたいときは，キヤリッジ • リターンをタイプする. 

終了 コマンド 

デバッガ作業を終了し， CP/M に戻るためには，” quit ” コマンドを使用す 
る. 

この コマンドは，フルスペルで 入力しなければ，受け付けられない. 


K .5 デバッガのコマンドのリスト 

文番号の定義 

文番号：=[行番号] [• 行の中の命令文の番号] 


式の定義 
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式 ： =* 式 

一次式 

一次式 ：二整数 

翻子 
(式） 

一次式[式] 

一次式.識別子 
一次式一〉識別子 

b [ reak ] [関数名][文番号[间数]] 

ブレーク •ポイントを設定す る. デフオルトは： 

_数名 税在の関数 

文番号 0 

回数 1 

clear 

全の ブレーク •ポイントを取り除く 

d Lump ] 式 [ multiple ] [ format ] 

式の結果を" format ” の書式で，” multiple ”回くり返す.デフオルト 

は： 

multiple 1 

format ” i ”または，シンボルの宣言による. 

同義語 p [ rint ] ,(カンマ） 

” format ”の指定は， 


c 


文字 
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P ポインタ 

i または w 整数/ワード 

s 文字列 


g [〇] 

実行を開始する. 


1 [ist] 

現在の関数と文番号を表示 


1 List] a [rguments] 

現在の関数の引数を表示 


1 List」b [reakpoints] 

全ての ブレーク •ポイントの表示 

1 [ist] g [lobals] 

全の グローバル 変数の表示 


1 [ist] 1 [ocals] 

現在の数内で宣言される変数の表示 


1 List] m Lap」 

ターゲット•プログラムのリンク.マップを表示 


1 List] t [raceback 」 

トレースされた関数を表示 


quit 



CP / M に戻る 
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r [ eset ] [_ 数名][文番号] 

ブレーク•ポイントを取り除く.デフオルトは， 
関数名 現在の関数 
文番号 0 


run 

実行を開始する.デバ'ッガへは戻らない. 


s [ et ] 式値 [ c ] • 

値をメモリーに設定する.値は16ビットとして扱われるが，次のようなと 
き，値は8ビットとして扱われる. 

(1) 式が char 変数のとき. 

(2) 式が引用符で_まれているとき • #，，のように） 

(3) ” c ’’オプションを指定したとき. 


t [ race ] [回数] 

トレース.実行された命令文を表示する.固数のデフォルトは1 


u [ ntrace ] [回数] 

トレース.ただし，実行された命令文を表示しない.回数のデフォルトは 
1. I 好]義語として w [ ork ] がある. 
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BD ソフトウェア C コンパイラ 
VI .50 a のための追加インフオメーシヨン 


Leor 乙 olman 
BD Software 
P.O.Box 9 
Brighton, Ma.02135 


この文書は， BDS C V1.50a に閲する追補の文書である.初めのセクシ 
ョンで，ソフトウェア（供結されたもの）と，コンピュータ•システム間 
の，非適合性について述べる.次のセクションで，コンパイラとライブラ 
リの新しい機能について述べ，最後のセクションでは， V1.50 で発見された 
バグについて述べる（これらのバグは， V1.50a では取り除かれている）. 


システムとの非適合性 


次に述べることは， V1.5 のユーザーズ •ガイドで述べられていない， コ 
ン パイ ラのコンフイグレーションや 操作に_する事である. 

• V1.50 の CDB デバ、 ッガと， C.CCC ランタイムパッケージには，危険な矛 
盾が存在する. BDS C のプログラムを，デバッガの下で走らせる場合， CC 
コンパイラに対して，オプションー k を指定する必要がある.これは，プ 
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ログラムをデバッグするために，コンパイラによって生成されたコードの 
中のさまざまな場所に” RST 6” （デフォルト）の命令を挿入するためであ 
る. CDB デバッガが起動すると， RST 6 のべクタ•エリア （ CP / M のべ一 
スページ内のロケーション 30 h ) からの数バイトに，ある命令を書き込む. 
もし， RST 6 のべクタを，なにかの割り込みハンドラーで使用しているな 
ら， CDB は，このべクタを書き換えてしまうので，システムが正常に動作 
しなくなってしまう.また， V 1.50 の BDS C ランタイム•パッケージ （ C . 
CCC ， ソースは CCC . ASM ) は，一 k オプションを指定してコンパイルされ 
たプログラムを，単体 （ CDB が，メモリーに存在しない）で走らせること 
を可能にするために， RST 6 のべクタを書き換えてしまう.したがって， 
RST 6 のべクタを使用しているシステムでは， C でコン ハ。 イルされたどん 
なプログラムも 実行することができない • 

V 1.50 a のランタイム•ハ。ッケージは，新しいオプションとして， RST の 
ロケーションの害き換えを行うか否かを指定することができる.したがっ 
て，一 k オプションを用いてコンパイルされたプログラムを，単体で実行 
するときに， RST のべクタを書き換えればよい • また，どの RST ベクタ 
を使用するかを任意に指定することができる.ランタイム • パッケージの 
デフォルトの設定は，システムの異常動作を招かないように，すべての 
RST ロケーションを害き換えない. 

もし，あなたのシステムが" RST 6 ”のベクタを使用していなければ， 
CCC . ASM 内の” USERST ” のシンボルを， " TRUE ” に定義し， CCC . 
ASM を再びアセンブルし，一 k オプションを用いてコンパイルされたプ 
ログラムを単体で走らせることを可能にするため，新しい C . CCC をつく 
ればよい. 

もし，あなたのシステムが” RST 6 ”のベクタを使用しているならば， 
CCC . ASM 内の " RSTNUM ”のシンボルを，空いているべクタ番号に変 
更し，” USERST ” のシンボルも，先に述べたように変更し，再びアセン 
ブルして，新しい C . CCC を生成する•そして，新しく設定された RST の 
ロケーションを使用する CDB を作成する ( CDB を作成する方法は ， CDB 
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解説書を見よ）. 


付 《 


あなたのシステムで，空いている RST ベクタがない場合， CDB を走ら 
せることはできない. 


• bios と bdos のライブラリ関数は， CP / M の BDOS が用いる ファン クショ 
ン • コールからの リ ターン 値を用いることを前提としている.これらは， 
すべての CP / M システムで動作するが， CP / M に準拠したシステム 

( SDOS , CDOS など）では，この限りではない.もし，このようなシステ 
ムを使用していて，正しく動作しないファンクション.コールがある場合 
は，あなたのオペレーティング•システムの BDOS が， HL に値を戻して 
いるか， BIOS が A に値を戻しているか…などを調べる必要がある.もし， 
それが，標準 CP / M の仕様と異なるものであるなら， bdos あるいは ， bios 
関数を正しい動作をさせるために書き直さなければならない. 

• BDS C の^^ライブラリ関数は，システムの000 Oh 番地 （ CP / M のべ一 

スページの敁初の命令）に書かれている BIOS ジャンプテーブルの2番目 
のエントリ (wboot) にジャンプする命令を基にしている.このようなシス 
テム以外（たとえば， Xerox 820) では， bios 関数は，正しく動作しないの 
で， BIOS ジャンプテーブルを正しく参照できるように，プログラムを書き 
直さなければならない. ， 


新しい閫数と特徴 


このセクションでは， ユーザーズ •ガイドで述べられていない新しい関数と, 
特徴について解説する. 


1. 次のライブラリ関数が，標準ライブラリに加えられた. 
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int fappend ( name , lobuf ) 
char * name ; 

FILE * iobuf ; 

この関数は，指定されたファイルが存在した場合，そのファイルの EOF 
からアペンド（追加）するために，オープンする.この関数は，テキスト 
ファイルにのみ使用される. 

lprintt ( format , argl , arg 2, …） 
char * format ; 

この_数は， printf 関数と同じ機能を有するが,その出力は， CP/MO 
” LIST "装置へ送られる. 

int index ( str , substr ) 
cnar 令 str , ^ substr ; 

str の文字列の中に substr の文字列が含まれていたら，その位置を戻す. 
見つからないときは，一1を戻す. 

int memcmp ( source ， dest , length ) 
char * source , 木 dest ; 
unsigned length ; 

source と dest から長さ length バイトのメモリーを比較し，完全に同じな 
らば真 （1) を，同じでなければ偽 （0) を戻す.この関数は，ァセンブリ言 
語で記述されているので，高速である. 


2. ハ。 ッ ケージに含まれる • CP.C ファイルコピーユーテイリテイは，新た 



付 


録 


に”ベリファイ”オプションを含んでいる•詳しい使い方は， CP . C のソー 
スコー ドを参照せよ • 

3. 新しいサンプル•プログラム DI . C が含まれている.これは，簡単な，フ 
ァイル比較ューテイリテイで，2つのファイルを高速に比較し，差異を表 
示する. 

4. TELEDIT . C テレコミュニケーション•プログラムが改良された.ユー 
ザー問のコミュニケーションを簡単にし，ファイル転送の技法を，簡潔に 
した. 


修正されたバグ 


次に述べるのは， V 1.50 に存在したバグのリストである. これらは, 
VI .50 a では，取り除かれている. 

1. CC と CLINK のデフオルト•ドライブに関する問題で，ある コンパイ 
ル，リンク条件のもとで，悪い論理ドライブをアクセスしてしまう.例え 
ば， CC.COM で用いるデフオルト•ドライブを，ドライブ C に設定したと 
する（セクション1.9.2.1で述べられている）. 

現在ログされているドライブが A だとして，次のコマンドを用いて，ド 
ライブ B のプログラムをコンパイルしたとする. 

A> CC brtest.c 

処理が始まり， test.c に含まれている デ、 フオルトのライブラリ領域を 参 
照する# include 命令（ファイルネームがく >で网まれている.）に出会う 
と，デフオルト•ドライブである A を検索せずに，ドライブ B を検索して 
しまう.この種の問題は他にもあるが，これらは， V 1.50 a では，発生しな 
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いようである. 

2. V1.50 の最も初期のもので，構造体の宣言を， 2 度使えないものがあっ 
た.例えば，次の文， 

struct foo { 
int a; 
int b; 

}; 

struct ioo foostruct; 

では， foostruct を宣言する部分で,” illegel identifire ”のエラーメッセ 
ージが出力される. 

3. CLIB プログラムで， デイスク名を付けた ファイルネームは ，6 文字まで 
しか，認識されない. 

4. 定義のない定義文があると，コンハ。イラは，動作しなくなる.例えば， 
次の命令など. 

# define BLANK /* 定義がない*/ 

5. 関数の宣言の間に，ホワイトスペースを入れると，宣言の処理ルーチン 
を混乱させる.次の例では，関数は，正しく宣言され ない . 

char* /* 通常， この 2 つの 行は， 1 つに される./* 

func ⑹ /* この方法は，正しいのだが正しく動作しない.*/ 

int n; 
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6. alloc と free 関数は，不意に，メモリー容 tt オーバー （Out of memory ) 
を起こす.特に，小さな大きさの割り当て領域の間の大きな割り当て領域 
を解除するときに発生する.このバグは，解除された領域を再び割り当て 
るときに，その領域の最後からではなく，最初から割り当てることによっ 
て取り除かれた（この修正をしてくれたウイリアム C . コーレー III に感謝 
する）. 

7. fprintf と printf 関数のあるバージョンで,ニューラインを正しく操作し 
ないものがある.これは，低 レベルの ライブラリ関数である ”_ fputc ” が 
正しくないからである.このバグの内容は，ニューライン記号を，ライン 
フイードを付加しない，単一の *\r ’ （ ASCII コードで ODh ) に変換し 
てしまうというものである. 

8. printf 関数のような，書式付き文字列を扱う関数で，書式付き文字列の最 
後の文字が％だと，正しく動作しなくなる. 

9. #include 文を操作しているときに発生するエラーメッセージの行番号 
は正しくない. 

10. CLINK で，（一 v オプションを用いて）オーバーレイセグメントを作成 
しようとすると，次のエラーメッセージが出力される. 


Warning ! Externals extend into BDOS ! 


Warning ! Exterals Overlap code ! 


このように表示されても，それが正しくない（つまり，エラーではない）こ 
とがある. 



あとがき 


CP / M -80 用に早い時期から安く販売されていた BDS C コンパイラ 
一は，米_内のユーザーズ•グループの協力により，より使いやすく強 
力になり，現在 （1984 年5片> バージョン 1.50 a となっています. 

私がライフボート社にマニュアルの和訳のことで話をした頃は，まだ 
バージョンが1.46のときでした. 

r 近くバージョンが大きく変わるので，新しいマニュアルを訳してほ 
しい』とライフボート社の社長•田先氏より連絡があり，数週間後まだ 
製本されていないサンプル用にタイプした版のコピーが送られてきまし 
た. 

また， ユーザーズ•グループ 発行の ニュースレター，ディスケット 数 
10枚も，後に私のところに屈きました.田先氏が自分の足で集めてこら 
れた国内には始めての資料でした. 

マニュアルの 直訳は，約3か H かかり，完成の頃には， H 本国内でも 
バージョン1 .50 版が発表されそ の 後，数か H に 100本も売れ るべ スト•セ 
ラー商品となりました. 

マニュアルは，直訳後，実際の使用の手引きとなるように，わかりや 
すい和文にする必要がありましたが，この時点から進まず約1年が過ぎ 
てしまったわけです.今回，工学図普 ㈱ より出版できることを喜ばしく 
思っています.タイプ版の誤字の多い英文，150ページ以上にわたり翻訳 
に協力していただいた久保明子嬢には心から感謝しています. 

本来なら，ライフボート社から使用マニュアルとして発売される性格 
のものを，出版物として発行するように勧めた私が，最後まで自分の手 
で行なえなかった事を心苦しく思っています. 

この和文マニュアルの出版により，多くの人が実際に C 言語を使用さ 
-れ，多くのソフトウェアが発表されることを願っています. 

1984年5月 


渡辺 修 
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